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WARNING  -  PRE-RELEASE  SOFTWARE! 
USE  CAUTION! 


Pre-release  versions  of  the  dBASE  IV™  Developer’s  Edition  are  not  intended  for  operation 
by  an  end  user,  but  are  made  available  for  the  purposes  of  evaluation  and  testing  only.  In 
pre-release  form,  the  software  is  likely  to  contain  "bugs"  and  may  behave  in  an 
unpredictable  manner.  The  possibility  that  the  software  may  corrupt  or  destroy  data  without 
warning  exists,  and  therefore  caution  should  be  taken  to  isolate  this  pre-release  software 
from  other  software  and  critical  data. 

In  addition  to  all  the  standard  features  of  dBASE  IV,  the  dBASE  IV  Developer's  Edition 
contains  a  number  of  tools  for  advanced  users  and  application  developers.  The  final  release 
of  the  dBASE  IV  Developer's  Edition  will  include  a  RunTime  module  (not  included  in  pre¬ 
release  versions)  which  will  permit  the  unlimited  distribution  of  executable  applications. 
See  the  brochures  enclosed  with  this  documentation  for  additional  details  on  these  products. 
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Getting  Started 
With  dBASE  IV 
Developer’s 
Edition  —  DOS 
Version 


Check  Your  dBASE  IV  Developer’s  Edition  Package 

Before  you  start  working  with  dBASE  IV  Developer’s  Edition,  look  over  the 
package  contents.  Your  dBASE  IV  Developer’s  Edition  package  contains  one 
disk  pack  binder,  two  angle  boxes,  and  one  three-ring  binder.  Check  that  you 
have  all  these  manuals,  disks,  and  materials: 

Installatioa  (disk  pack  binder) 

■  Guide  to  dBASE  IV Developer’s  Edition  fold-out  card 

■  Customer  Support  Guide 

m  A  Warranty  Registration  Card 

■  Aset  of  {{Ibtal  TBD}}  5  1/4  inch  disks,  as  follows: 


_  OR 


Installation  Disk 

Developer’s  Edition  System  Disk  #  1 

System  Disk  #  2 

System  Disk  #  3 

System  Disk  #  4 

System  Disk  #  5 

System  Disk  #  6 

System  Disk  #  7 

Samples  Disk  #  1 

Samples  Disk  #  2 

Samples  Disk  #  3 

Developer’s  Utilities  Disk 

RunTime  Disk  #  1 

RunTime  Disk  #  2 

RunTime  Disk  #  3 

Template  Language  Toolkit  Disk 
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■  A  set  of  {{Total  TBD}}  3  1/2  inch  disks,  as  follows: 

Installation  Disk 

Developer’s  Edition  System  Disk  #  1 

System  Disk  #  2 

System  Disk  #  3 

System  Disk  #  4 

System  Disk  #  5 

System  Disk  #  6 

System  Disk  #  7 

Samples  Disk  #  1 

Samples  Disk  #  2 

Samples  Disk  #  3 

Developer’s  Utilities  Disk 

RunTime  Disk  #  1 

RunTime  Disk  #  2 

RunTime  Disk  #  3 

Template  Language  Toolkit  Disk 

■  IWo  function  key  templates 

■  IWo  sheets  of  disk  labels  (for  backups  and  data) 

Usiag  dBASE  IV  Developer’s  Edition  (angle  box) 

■  dBASE  TV  Change  Summary 

■  Using  the  Menu  System 
m  Network  Installation 

m  Networking  with  dBASE  IV 

■  Iking  the  dBASE  IV  Applications  Generator 
m  Iking  dBASE  IV  SOL 

■  Quick  Reference 

Program aing  Gaides  (angle  box) 

■  Programming  with  dBAS  E IV 

■  Sample  Programming  Code 
m  RunTime  and  Utilities 

■  Tim  plate  Language 

Language  Reference  (three-ring  binder) 

■  Language  Reference 

If  your  package  is  missing  any  of  these  items,  contact  your  Ashton-Tate 
dealer  immediately. 
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Send  Your  Warranty  Registration  Card 

Your  package  includes  a  Warranty  Registration  Card.  Mailing  this  form 
makes  you  a  licensed  user  of  the  program.  It  entitles  you  to  receive  program 
updates  at  a  modest  charge,  and  90  days  of  free  telephone  support. 

Be  sure  to  mail  this  card  to  us  within  30  days  of  the  date  you  purchased 
dBASE  IV  Developer’s  Edition.  Refer  to  the  Customer  Support  Guide  for  a 
complete  description  of  Ashton-Tkte's  support  policies. 


How  to  Use  This  Booklet 

This  booklet  tells  you  how  to  get  started  with  single -user  d  B  AS  E  IV  only. 
Single-user  dBASE  IV  does  not  allow  you  to  share  programs  or  data  files, 
even  if  you  are  connected  to  a  network. 

If  you  want  to  share  programs  and  data  files  on  a  network,  see  Network 
Installation  to  install  multi-user  dBASE  IV.  Then  return  to  this  guide  to  learn 
about  dBASE  IV  documentation  and  the  paths  that  you  can  take  while  usins 
dBASE  IV. 


Conventions  Used  in  dBASE  IV  Manuals 

Understanding  the  information  in  the  manuals  is  easier  when  you  are  aware 

of  the  following  conventions: 

■  The  word  press  is  used  for  keys  you  press;  the  word  type  or  enter  is  used 
for  information  you  must  type  in. 

■  Function  keys  (in  the  dedicated  keypad  on  your  keyboard)  are  shown  by 
themselves  (FI)  or  with  their  assigned  functions  (FI  Hdp). 

■  Commands  or  entries  that  you  type  appear  in  a  different  typeface  and 
color. 

■  Instructions  to  press  the  RETURN  or  ENTER  key  are  represented  by  the 
«-»  symbol. 

■  Italics  are  used  for  new  terms  when  they  first  appear,  and  also  for 
emphasis  within  the  text. 

■  Menu  names  and  items,  messages  you  receive  from  the  program,  and 
other  on-screen  references  are  in  bold  type. 

■  Program  listings  appear  in  a  different  typeface,  with  a  shaded 
background. 

■  Displays  of  computer  screens  and  illustrations  show  the  correct  results 
of  your  instructions  to  the  program,  or  clarify  a  definition  or  instruction. 

■  Notes  and  tips  are  in  italics,  with  special  marks,  so  you'll  be  sure  to  see 
them.  Warnings  have  lines  above  and  below  their  text,  in  addition  to  the 
warning  mark,  and  thus  stand  out  even  more. 


GETTING  STARTED  WITH  dBASE  IV  DEVELOPER’S  EDITION  -  DOS  VERSION 


GS-3 


.CBNAHE:  PAGE:  a  SESS:  3  U«d  nay  18  18:09:30  1388 

St  at  e/d  i  sk2/a  I  I  j  ofiz/CLS.manhat/GRPjttanhat/ JOBjwartgeti  t/OI  V_gsm«g  i  c 

Notes  explain  exceptions  to  or  provide  additional  information  about  gen¬ 
eral  rules.  Tips  give  you  helpful  hints  or  shortcuts.  Warnings  help  you 
avoid  disastrous  events  such  as  losing  data. 


Hardware  and  Software  Requirements 

You  can  run  dBASE  IV  Developer’s  Edition  —  DOS  Version  on  the  IBM*  PC, 
Personal  Computer  AT*,  PC/XT’",  or  100%  compatible  computers,  IBM  Per¬ 
sonal  System/2*"  models  30,  50,  60,  and  80,  and  the  Compaq  Deskpro  386™. 

dBASE  IV  —  DOS  Version  runs  with  IBM  Personal  Computer  DOS 
(PC-DOS™)  release  2.x  or  greater,  or  MS-DOS*  release  2.x  or  greater. 

You  cannot  run  dBASE  IV  on  a  microcomputer  that  does  not  have  a  hard 
disk  drive. 

To  use  dBASE  IV  on  a  hard  disk  computer,  you  must  have  at  least  700K 
bytes  free  on  your  hard  disk  and  xxxK  bytes  of  free  memory. 


You  cannot  run  dBASE  IV  if  you  have  less  than  640K  installed  RAM. 

You  can  install  dBASE  IV  using  the  supplied  5  1/4  inch  or  3  1/2  inch  disks. 
You  can  use  any  5  1/4  inch  floppy  disk  drive  to  install  dBASE  IV. 

With  dBASE  IV,  you  can  use  most  popular  printers. 

Programs  loaded  prior  to  dBASE  IV  that  remain  in  memory,  such  as 
SideKick™ or  ProKey™,  will  adversely  affect  dBASE  IV*s  performance. 
dBASE  IV  will  run  faster  without  any  other  program  in  memory. 


Installing  Single-User  dBASE  IV 

You  can  install  dBASE  IV  on  a  single-user  system  or  a  mu  Id-user  system.  This 
section  describes  how  to  use  the  Install  progam  in  order  to  set  up  the  single- 
user  version  of  dBASE  IV  Diveloper’s  Edition. 

If  you  install  dBASE  IV  as  a  single-user  system,  you  will  use  dBASE  on  a 
microcomputer  that  is  not  attached  to  a  network. 

If  you  have  purchased  one  of  the  network  software  packages  certified  to  run 
dBASE  IV,  you  can  install  dBASE  IV  to  allow  access  from  more  than  one 
microcomputer.  Do  not  perform  the  single-user  installation  described  below. 
Instead,  follow  the  procedures  in  Network  Instell»tion. 

This  section  describes  how  to  use  the  Install  progam  in  order  to  set  up  the 
single-user  version  of  dBASE  IV  Developer’s  Edition. 
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Before  You  Begin 

Install  copies  the  following  programs  and  related  files  to  your  hard  disk: 

Single-user  dBASE  IV 

dBASE  IV  Applications  Generator 

dBASE  IV  Structured  Query  Language  (SQL) 

Config.db 

dBASE  IV  RunTime  (optional) 

Autoexec.bat  (optional) 

Config.sys  (optional) 

dBASE  IV  Template  Language  (optional) 

Sample  files  (optional) 

DBSETUP  (optional) 

Be  aware  of  the  following  considerations  when  installing  single-user 
dBASE  IV: 

■  The  Install  program  is  very  flexible.  It  allows  you  to  copy  or  not  copy  all 
optional  files,  and  lets  you  change  the  drive  and  directory  in  which  files 
are  installed. 

■  Install  verifies  that  there  is  enough  space  on  a  specified  drive  before  it 
begins  to  copy  any  system  files  or  optional  files. 

■  You  need  not  create  any  directories  before  using  Install.  The  program 
creates  directories  for  you  during  the  installation  process,  or  you  can  use 
existing  directories  on  your  hard  disk. 

These  instructions  are  written  with  the  assumption  that  your  microcomputer 
starts  up  on  the  hard  disk.  Drive  A  refers  to  the  diskette  drive  and  drive  C 
refers  to  the  hard  disk.  If  you  have  a  different  drive  letter  name  for  your  hard 
disk,  substitute  that  letter  for  C  in  these  instructions. 


WARNING 

If  you  want  to  have  both  single-user  and  multi-user  dBASE  IV  on 
your  hard  disk,  be  sure  to  install  them  into  separate  directories. 
There  are  common  files  between  the  different  versions  that  will 
conflict  with  each  other  if  they  are  in  the  same  directory.  To 
install  multiuser  dBASE  IV,  follow  the  instructions  in  Network 
Installation. 


If  you  have  any  previous  version  of  dBASE  on  your  hard  disk,  you  have  two 
choices: 

«  Tb  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  Tb  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 
that  contains  the  previous  version.  The  previous  version  will  be  automat¬ 
ically  deleted.  (Your  data  files,  however,  will  be  left  intact.) 
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Installing  dBASE  IV 

To  install  dBASE  IV  Developer's  Edition  on  your  hard  disk,  follow  these 
steps: 

1.  Insert  the  Installation  Disk  in  drive  Aofyour  microcomputer. 

2.  Make  drive  A  the  default  drive  by  typing  A:  The  A>  prompt  appears 

on  the  screen. 

3.  Type  install  — .  After  a  few  seconds,  the  dBASE  IV  copyright  screen 
appears.  Press  ♦♦  to  continue. 

4.  Follow  the  prompts  that  appear  on  the  screen. 

Software  Registration 

Before  you  install  dBASE  IV  Developer’s  Edition  for  the  first  time,  you  must 
complete  the  Software  Registration  screen  to  identify  this  copy  as  your  own. 

Enter  your  name,  your  company  name,  and  the  serial  number  from  System 
Disk  #  1.  Press  to  move  the  cursor  to  the  next  line.  Press  Cut-End  to  save 
this  information.  The  information  you  enter  cannot  be  changed  after  you 
save  it. 

To  abandon  the  registration  screen  without  saving  the  registration  informa¬ 
tion,  press  Esc. 

NOTE 

Your  company  may  not  want  you  to  enter  your  name  on  the  screen. 
Please  contact  the  appropriate  person  in  your  company  for  any  spe¬ 
cial  instructions  on  completing  the  Software  Registration  screen. 

There  are  three  phases  to  this  installation.  In  the  first  phase,  you  describe 
your  hardware  environment.  In  the  second,  you  specify  a  target  drive  and 
directory,  and  install  dBASE  IV  system  files.  In  the  final  phase,  you  have 
the  option  to  copy  dBASE  IV  Template  Language  files,  sample  files,  and 
DBSETUP. 


Hardware  Setup 

After  you  have  saved  the  information  entered  on  the  Software  Registration 
screen,  the  Hardware  setap  menu  appears. 

Use  this  menu  to  specify  whether  you  want  to  install  multi-user  dBASE  IV, 
the  display  mode  you  will  be  using,  whether  you  want  to  optimize  your  color 
display,  and  the  printers  you  will  be  using. 

MuM-Usar  Installation 

The  default  for  this  field  is  No.  Do  not  change  this  field  for  single-user  instal¬ 
lation.  Press  <**.  The  cursor  moves  to  the  Display  mode  field. 
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Display  Mods 

This  field  contains  the  following  options:  MONO,  M0N043,  COLOR, 

EGA25,  EGA43,  and  VGA25.  Press  Spacebar  to  cycle  through  the  choices. 
Press  to  select  the  display  mode  that  matches  your  hardware.  The  cursor 
moves  to  the  Optimize  color  display  field. 

Optimize  Color  Display 

If  you  select  this  field  by  pressing  *»,  you  are  prompted  to  correct  a  “snow  ’’ 
effect  on  your  monitor. 

If  you  select  Cancel,  the  system  redisplays  the  Hardware  setup  menu.  If  you 
select  Proceed,  you  are  asked  if  you  see  a  "snow”  effect  on  your  monitor 
right  now. 

If  you  see  snow  on  your  monitor,  press  or  Y.  Otherwise,  press  N  to  select 
No.  The  Hardware  setup  menu  reappears. 

Printers 

Ybu  can  install  up  to  four  printer  drivers  in  addition  to  the  Ascii. dpr  and 
Generic. dpr  printer  drivers  which  are  installed  automatically.  If  you  do  not 
specify  any  printer  drivers,  dBASE  IV  uses  the  Generic. dpr  printer  driver.  If 
you  select  Priaters  from  the  Hardware  setup  menu,  the  following  informa¬ 
tion  appears: 


Table  1  Printer  driver  selection 


Printer  name  Printer  driver 

1.  Epson  LX -80/ 90  LXSQ.dpr -LPT^  A 

2. 


3. 

4. 


Device 

A 


'  LXKUp r  j  L? 


This  table  lets  you  specify  up  to  four  printer  drivers  and  the  DOS  device 
assigned  to  each  printer.  The  first  entry  you  specify  in  the  table  contains  the 
default  printer  driver  and  device  used  with  dBASE  IV.  This  printer  name  will 
appear  on  the  Hardware  setup  menu. 
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;o  select  printer  drivers  from  a  list,  press  Shift-Flfwith  the  cinor  in  the) 
Printer  name  column.  The  following  information  appears:  ’ 

Table  2  Printer  Driver  list 

Printer  driver  Printer  name 

LX80.dpr  Epson  LX-80/90 


Press  Tabor  Shift-Tab  to  move  between  the  columns.  Tab  moves  the  cursor 
to  the  right  and  Shift-Tab  moves  the  cursor  to  the  left.  If  you  move  to  the 
outer  column,  the  next  Tabor  Shift-Tab  wraps  around  to  the  opposite 
column. 

Press  Shift-Pi  (fiTthe)  Pri  ater  driver  column  to  display  a  list  of  printer  driver 
filenames.  As  you  scroll  through  either  column,  the  adjacent  box  indicates 
the  associated  driver  filename  or  printer  name,  depending  on  where  you 
press  Shift-FI .(XSc  table  above  shows  the  lift  and  adjacent  boa  whea  yoa) 
fprej^  Shift in  the  Printer  a  a  me  colUfflnTlf  you  move  the  cursor  to  a 
printer  name  in  the  list,  the  appropriate  printer  driver  filename  automati¬ 
cally  displays  in  the  Printer  driver  column.  Conversely,  if  you  move  the  cur¬ 
sor  to  a  printer  driver  filename  in  the  Printer  driver  column,  the  appropri¬ 
ate  printer  name  automatically  displays  in  the  Printer  naaae  column.  The 
selection  of  a  printer  name  uses  two  screens.  The  first  screen  lists  the  names 
of  the  printer  manufacturers.  The  second  lists  the  printer  models. 

To  enter  a  driver  name  that  is  not  in  the  Printer  driver  column,  simply  type 
the  appropriate  information  in  the  Printer  name  and  Printer  driver 
columns  of  the  table. 

The  Device  column  contains  tie  following  options:  LPT1,  LPT2,  LPT2, 
COM1,  COM2,  \\S POOLER,  and  \\CAPTURB.  Press  the  Spacebar  to  cycle 
through  the  choices.  The  first  device  you  select  will  be  the  default  or  startup 
device. 

When  you  have  selected  the  printer  names,  printer  drivers,  and  devices  for 
your  system,  press  Ctri-End  to  save  this  information.  The  selected  printer 
drivers  will  be  copied  to  your  hard  disk  and  the  specified  devices  will  be 
assigned  to  the  specified  printers.  Press  Etc  to  exit  this  table,  abandon  all 
selections  and  return  to  the  Hardware  setup  menu. 


( Hi ) 
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Installing  dBASE  IV  System  Rles 

Before  the  dBASE  IV  system  files  are  installed,  you  are  given  the  chance  to 
verify  your  hardware  settings,  specify  the  hard  disk  drive  and  directory 
where  the  system  flies  will  reside,  and  correct  other  conditions.  Some  of 
these  are:  insufficient  space  on  the  specified  disk,  the  target  directory  does 
not  exist,  the  target  directory  already  exists,  or  there  is  a  copy-protected  ver¬ 
sion  of  dBASE  in  the  target  directory. 

Hi  netware  Settings  Verification 

After  you  save  the  hardware  setup  information,  the  Install  program  tells  you 
that  you  are  ready  to  install  single-user  dBASE  IV.  You  are  prompted  to  pro¬ 
ceed  with  the  installation,  or  exit. 

Select  Proceed  to  install  single-user  dBASE  IV,  Modify  hardware  setup  to 
return  to  the  Hardware  setap  menu,  or  Exit  to  leave  the  Install  program.  If 
you  select  Exit,  the  system  displays  the  exit  prompts  described  in  the 
“Exiting  Install"  section  near  the  end  of  this  chapter. 

Orivs  and  Directory  Verification 

Before  you  start  the  installation  of  the  dBASE  IV  system  files,  you  are 
prompted  to  verify  the  drive  and  directory  in  which  to  install  them. 

The  cursor  is  under  the  character  at  the  far  left  of  the  field  (the  drive  letter). 
You  can  change  the  drive  and  directory  by  typing  at  your  keyboard.  Press  ♦* 
to  accept  the  default  drive  and  directory,  or  enter  the  correct  drive  and 
directory  and  press  return?** 

Correcting  Othar  Conditions 

Before  the  installation  begins,  the  system  checks  the  following: 

1.  Is  there  enough  space  on  the  disk  that  contains  the  target  directory?  If 
not,  you  will  be  given  an  opportunity  to  reassign  the  target  drive. 

If  you  select  Exit,  the  standard  exit  prompts  appear.  If  you  select 
Change  drive,  you  are  prompted,  as  before,  to  verify  the  drive  and  direc¬ 
tory  in  which  to  install  the  dBASE  IV  system  files. 

Press  *♦  to  accept  the  default  drive  and  directory,  or  enter  the  correct 
drive  and  directory  and  press  *•. 

2.  If  the  target  directory  does  not  exist,  the  system  will  create  it  for  you  or 
let  you  specify  a  new  drive  and  directory. 

If  you  select  Proceed,  the  Install  program  creates  the  directory  and  the 
installation  process  continues.  If  you  select  Change  drive/ directory  or 
press  Esc,  you  are  prompted  to  enter  the  new  drive  and  directory. 

3.  If  dBASE  already  exists  in  the  target  directory,  the  system  allows  you  to 
overwrite  it,  or  to  change  the  target  drive  and  directory. 

If  you  select  Proceed,  the  dBASE  system  files  in  the  current  directory 
—  are  deleted  before  the  dBASE  IV  files  are  installed.  If  you  select  Change 
drive/ directory  or  press  Eac,  you  are  prompted  to  enter  the  new  drive 
and  directory. 
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4.  If  the  system  detects  a  copy-protected  version  of  dBASE  in  the  specified 
target  directory,  you  must  either  specify  a  different  drive  and  directory 
or  use  the  Uninstall  program  provided  with  that  version  of  dBASE  before 
installing  dBASE  IV. 

If  you  select  Change  drive/  directory,  the  prompt  for  changing  the  tar¬ 
get  drive  and  directory  appear.  If  you  select  Exit,  the  system  displays  the 
exit  prompts  described  in  the  “Exiting  Install''  section  near  the  end  of 
this  chapter. 

Copying  System  Flee 

After  the  system  determines  that  dBASE  IV  can  be  installed  in  the  target 
directory,  the  system  prompts  you  to  insert  System  Disk  #1  into  the  source 
drive. 

The  number  of  disks  that  you  insert  depends  on  the  size  of  your  disks  (5  1/4 

or  3  1/2  inch). 

Before  the  required  SQL  system  files  can  be  copied,  you  are  prompted  for 
the  drive  and  directory  in  which  to  install/~them. 

Press  to  accept  the  default  drive  and  directory,  or  enter  the  correct  drive 
and  directory  and  press  «-*. 

The  system  creates  the  directory  on  the  specified  drive  and  copies  the  follow¬ 
ing  files  to  that  directory: 

■  A  master  (empty)  Sysdbs.dbf 

■  The  RunTime. dbo  file  required  by  SQL 

■  A  full  set  of  empty  SQL  system  catalogs 

The  system  also  writes  the  following  statement  to  Config.db: 

SQLHOME-  <  path  > 

where  <  path>  represents  the  specified  drive  and  directory  (for  example, 
C:\DBASE\SQLHOME)  for  the  SQL  home  directory. 

Copying  Conflg.db 

After  the  system  copies  the  SQL  files,  you  specify  the  drive  and  directory 
where  Config.db  will  reside. 

Press  to  accept  the  default  drive  and  directory,  or  enter  the  correct  drive 
and  directory  and  press  **. 

A  message  confirms  that  the  dBASE  IV  system  files  have  been  successfully 
installed.  In  addition,  you  are  prompted  to  install  other  files  or  exit  Install. 
Press  ♦*  to  copy  other  files  to  your  hard  disk,  or  select  Exit  and  press  «-». 
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Copying  Other  Res 

This  part  of  the  installation  allows  you  to  optionally  copy  dBASE  IV 
RunTime  files,  modify  your  Autoexec.bat  file,  update  your  Config.sys  file,  and 
copy  dBASE  IV  Template  Language  files,  sample  files,  and  DBSETUP 

Copying  RunTime  Files 

After  Config.db  has  been  successfully  copied,  the  system  prompts  you  to 
install  the  RunTime  files.  Select  Skip/if  you  do  not  want  to  copy  them.  If 
you  select  Proceed,  the  system  asks  you  to  insert  RunTime  Disk  #1  in  drive 
A.  Select  Transfer  files  to  copy  the  files,  or  Caacel  to  return  to  the  previous 
prompt.  The  RunTime  files  are  copied  into  the  directory  that  you  specified 
for  the  dBASE  IV  system  files. 

Modifying  Autoexec. bat 

After  you  copy  the  RunTime  files  (or  choose  to  skip  this  step),  the  system 
allows  you  to  append  the  dBASE  IV  directory  name  to  the  DOS  path  state¬ 
ment  in  your  Autoexec.bat  file. 

Ifyou  select  Skip,  the  Autoexec.bat  file  is  not  updated  and  the  program 
moves  on  to  the  next  step  (updating  Config.sys).  Ifyou  press  Em,  the  previ¬ 
ous  prompt  appears. 

Ifyou  select  Proceed,  the  Install  program  checks  to  see  whether  an^Autoe- 
xec.bat  file  exists  on  your  system.  If  it  does,  and  if  it  contains  a  PATH  state¬ 
ment,  the  dBASE  IV  directory  name  is  appended  to  the  PATH  command,  pro¬ 
viding  there  is  enough  room.  If  the  addition  of  the  directory  name  were  to 
exceed  the  DOS  limit  on  the  number  of  characters  allowed  in  a  PATH  state¬ 
ment,  the  system  notifies  you.  You  can  then  proceed  with  the  installation  and 
modify  your  PATH  statement  later,  ifyou  cl^>se. 

If  no  PATH  statement  exists  in  your  Autoexec.bat  it  is  added.  The  system  first 
creates  a  backup  file  called  Autoexec .bak.  If  it  cannot  find  Autoexec.bat  in 
the  root  directory  on  the  startup  drive,  the  system  notifies  you  and  lets  you 
create  one.  If  you  select  Proceed,  the  system  creates  an  Autoexec.bat  file 
with  the  dBASE  IV  directory  in  the  PATH  statement.  Ifyou  select  Cancel,  the 
program  does  not  create  an  Autoexec.bat  file  and  skips  to  the  next  step.  If 
you  press  Esc,  the  system  displays  the  prompt  dBASE  IV  can  be  ran  from 
any  directory... 

The  system  also  checks  to  make  sure  the  dBASE  path  is  not  already  in  the 
DOS  PATH  statement. 

Ifyou  choose  to  create  or  modify  an  Autoexec.bat  file,  be  sure  to  reboot 
your  microcomputer  after  this  installation. 

Updating  Conflg.sya 

After  you  modify  your  Autoexec.bat  file  (or  choose  to  skip  this  step),  the  sys¬ 
tem  allows  you  to  update  your  Config.sys  file. 

Ifyou  select  Skip,  the  Config.sys  file  will  not  be  updated  and  Install  goes  to 
the  next  step  (copying  sample  files).  If  you  press  Enc,  the  system  displays  the 
prompt  that  confirms  the  installation  (dBASE  IV  has  been  installed  suc- 
ceaafnOy...). 
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If  you  select  Proceed,  the  system  checks  for  the  existence  of  a  Config.syu  If  -r  (  |& 

Config.sys  is  found,  and  prior  to  making  any  changes  to  Config.sys,  Install  A 

will  save  a  backup  copy  (Config.bak).  Install  will  then  check  Config.sys  for 

the  FILES  and  BUFFERS  statements.  If  the  value  for  FILES  is  less  than  20,  it 

will  update  the  FILES  statement  to  FILES  -  20.  Likewise,  if  the  value  for 

BUFFERS  is  less  than  15,  it  will  update  the  BUFFERS  statement  to  BUFFERS 

-  15;  otherwise,  it  will  not  change  the  settings. 

If  Config.sys  cannot  be  found,  the  system  displays  a  prompt  asking  you  if  you 
want  to  create  a  Config.sys  file. 

If  you  select  Proceed,  the  system  creates  a  Config.sys  file  containing  these 
statements: 

FILES  -  20 
BUFFERS  -  15 

If  you  select  Cancel,  Config.sys  is  not  created  and  Install  goes  to  the  next 
step.  If  you  press  Esc,  the  system  displays  the  previous  prompt. 

Copying  Template  Language  Files 

After  you  update  your  Config.sys  file  (or  choose  to  skip  this  step),  the  system 
prompts  you  to  copy  the  dBASE  IV  Template  Language  toolkit. 

If  you  select  Skip,  Install  goes  to  the  next  step  (copying  sample  files).  If  you 
select  Proceed,  the  system  asks  you  to  insert  the  Thm plate  Language  Disk 
into  drive  A.  Select  IVaasfer  files  to  begin  the  copying,  or  Caacel  to  return 
to  the  previous  prompt. 

If  you  choose  to  copy  the  Template  Language  toolkit,  the  system  asks  you  to 
enter  the  drive  and  directory  in  which  to  copy  these  files. 

The  default  directory  is  \DBASE\DTL.  Press  *•  to  accept  the  default  drive 
and  directory,  or  enter  the  correct  drive  and  directory  and  press 

Copying  Sampl#  F3aa 

After  you  copy  the  Ifcmplate  language  files  (or  choose  to  skip  this  step),  the 
system  prompts  you  to  copy  the  samples  files. 

If  you  select  Skip,  the  program  goes  to  the  next  step  in  the  installation  pro¬ 
cess  (copying  the  tutorial  files).  If  you  press  Esc,  the  system  displays  the 
prompt  that  confirms  the  installation  (Siagle-aser  system  files  have  bcea 
installed  successfully).  If  you  select  Proceed,  you  are  prompted  to  confirm 
the  drive  and  directory  in  which  to  place  the  sample  files. 

The  default  directory  is  \DBASE\SAMPLES.  Press  — ►  to  accept  the  default,  or 
change  the  drive  or  directory  and  press  — ►.  If  you  press  Esc,  the  system  dis¬ 
plays  the  previous  prompt. 

After  you  press  you  are  prompted  to  verify  the  specified  drive  and  direc¬ 
tory.  Press  to  accept  the  drive  and  directory,  or  select  Cancel  and  press 
-►to  display  the  praniniu 

If  there  is  not  enough  space  on  the  specified  drive  to  copy  the  sample  files, 
you  are  prompted  to  change  your  target  drive,  or  to  skip  the  samples 
installation. 
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If  you  select  Change  the  prompt  for  entering  the  drive  and  directory 

appears  again.  If  you  select  Skip,  the  program  goes  to  the  next  step  in  the 
installation  process  (copying  the  tutorial  files). 

Install  creates  a  batch  file  called  Dbsamples.bat  and  places  it  in  the  dBASE 
directory.  This  batch  file  contains  the  following  commands: 

ECHO  OFF 
C: 

CD\dBASE\SAMPLES 

dBASE 

The  drive  and  directory  will  be  the  drive  and  directory  you  specify  for  the 
sample  files. 

After  the  system  copies  the  sample  files.  Install  will: 

■  Update  Sysdbf.dbf  in  the  SQL  directory  to  contain  the  name  of  the  sam¬ 
ple  database  and  path  to  it  (\dBASE\SAMPLES). 

■  Place  SQLDATAB ASE -  <  database  name>  in  Config.db,  where 

<  database  name>  is  the  name  of  the  SQL  sample  database  (SAMPLES, 
by  default). 

If  you  decide  not  to  copy  the  sample  files,  SQLDAIABASE  •  will  not  be 
written  to  the  Config.db  file. 

Copying  DBSETUP 

See  the  previous  explanation  for  sample  files.  The  default  directory  will  be 
the  dBASE  directory. 

If  the  Installation  Disk  cannot  be  found,  you  are  prompted  to  insert  it  in  the 
source  drive. 

Press  ♦*  to  complete  the  installation. 


Exiting  Install 

When  you  exit  Install,  you  can  transfer  control  to  DOS  or  to  DBSETUP.  The 
DBSETUP  program  includes  a  Config.db  editor.  See  the  Language  Reference 
manual,  Chapter  6,  for  information  on  how  to  edit  Config.db. 

You  are  prompted,  next,  to  exit  to  DOS  or  to  transfer  to  DBSETUP. 

If  you  select  Exit  to  DOS,  Install  exits  to  the  DOS  prompt.  If  you  select 
Transfer  to  DBSETUP,  Install  exits  to  the  first  item  in  the  IastmH  menu  in 
DBSETUP. 

If  you  cancel  the  installation  before  it  finishes,  a  prompt  appears  asking  you 
if  you  want  to  abandon  the  installation.  If  you  select  lbs  and  changes  were 
made  to  the  Hardware  setup  menu,  you  are  asked  if  you  want  to  save  those 
changes,  and  for  the  drive  and  directory  in  which  to  save  them. 
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Uninstalling  dBASE  IV 


To  uninstall  dBASE  IV,  select  Uninstall  dBASE  IV  from  the  DBSETUP 
menu.  You  are  prompted  to  enter  the  drive  and  directory  from  which  to 
uninstall.  The  default  is  the  current  DOS  drive  and  directory. 

If  you  press  Eac,  the  system  displays  the  Install  menu.  Press  *-»  to  accept  the 
drive  and  directory.  Uninstall  checks  for  the  existence  of  the  drive  and  direc¬ 
tory.  If  the  target  drive  or  directory  does  not  exist,  you  are  prompted  to 
change  the  drive  and  directory,  or  cancel  the  uninstall  process. 

If  you  select  Cancel  or  press  Eac,  the  system  displays  the  Install  menu.  If 
you  select  Change  drive/ directory,  the  prompt  for  entering  the  drive  and 
directory  appears. 

If  the  system  finds  the  specified  drive  and  directory,  Uninstall  checks  to  see 
if  dBASE  IV  exists  in  that  directory.  If  dBASE  IV  is  not  present,  you  are 
asked  if  you  would  like  to  change  the  drive  and  directory. 


If  you  select  No,  the  Install  menu  appears.  If  you  select  Yss  or  press 
ECfifr’thc  previous  prompt  appears. 


If  the  system  finds  the  drive  and  directory  and  it  contains  dBASE  IV,  Unin' 
stall  deletes  all  the  dBASE  IV  system  files.  Uninstall  also  checks  for  empty 
subdirectories  (below  the  dBASE  directory).  If  it  finds  an  empty  subdirec¬ 
tory,  it  prompts  you  to  remove  this  subdirectory  from  the  disk. 


This  process  continues  until  you  have  been  prompted  about  all  the  empty 
subdirectories  below  the  dBASE  directory. 


When  the  uninstall  process  is  complete,  a  confirmation  message  appears, 
followed  by  a  prompt  to  return  to  the  Exit  menu. 


Press  any  key  to  display  the  Install  menu.  You  can  then  exit  to  the  DBSETUP 
program  or  to  DOS  through  the  Exit  menu. 

The  default  is  the  current  DOS  drive/ directory.  If  you  press  Esc,  the  system 
displays  the  Install  menu.  Press  •*-*  to  accept  the  drive/ directory.  Uninstall 
checks  for  the  existence  of  the  drive  and  directory.  If  the  target  drive  or 
directory  does  not  exist,  the  system  prompts  you  to  change  the  drive  and 
directory. 

If  you  select  Cancel  or  press  Esc,  the  system  displays  the  Install  menu.  If 
you  select  Change  drive/ directory,  the  previous  prompt  appears. 


If  the  system  finds  the  specified  drive  and  directory,  Uninstall  checks  to  see 
if  dBASE  IV  exists  in  that  directory.  If  dBASE  IV  is  not  there,  the  system 
prompts  you  to  change  the  drive  and  directory. 


If  you  select  No,  the  Install  menu  appears.  If  you  select  Kbs  or  press  Eac, 
the  previous  prompt  appears. 

If  the  system  finds  the  drive  and  directory  and  it  contains  dBASE  IV,  Unin¬ 
stall  deletes  all  of  the  dBASE  IV  system  files.  Uninstall  also  checks  for  empty 
subdirectories  (below  the  dBASE  directory).  If  it  finds  an  empty  subdirec¬ 
tory,  the  system  asks  you  if  you  want  to  remove  it. 


ThiS^process  continues  until  you  have  been  asked  about  all  of  the  empty  sub¬ 
directories  below  the  dBASE  directory. 


^ C 
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When  the  uninstall  process  is  complete,  a  confirmation  boa  appears  telling 
you  that  dBASE  IV  has  been  successfully  uninstalled. 

Press  any  key  to  display  the  Install  menu.  You  can  then  exit  to  the  DBSETUP 
program  or  to  DOS  through  the  Exit  menu. 


Making  a  Backup  Copy 

You  should  make  a  backup  copy  of  each  disk  included  in  your  dBASE  IV 
Developer’s  Edition  package.  Make  the  copies  immediately  after you  install 
dBASE  IV  Developer’s  Edition.  Use  the  DOS  DISKCOPY  command,  or 
another  backup  utility,  to  complete  this  task.  If  you  need  more  information, 
consult  your  DOS  manual. 

After  you’ve  made  the  backup  copies,  store  the  complete  set  of  original  disks 
in  a  safe  place.  Then  use  only  the  copies.  You  cannot  predict  when  you  may 
need  an  original  program  disk  to  replace  a  damaged  backup  copy. 


What  To  Do  Next 


The  dBASE  IV  Developer’s  Edition  documentation  has  been  designed  for 
intermediate  to  experienced  dBASE  users.  Recommended  learning  paths  are 
described  in  the  following  two  sections. 


Intermediate  dBASE  Users 

If  you’re  familiar  with  dBASE  but  want  to  know  more  about  this  product, 
you  can  read  the  following: 

■  The  dBASE  IV  d sage  Summary,  to  find  out  the  differences  between  pre- 
vious  versions  of  dBASE  and  dBASE  IV. 

■  Programming  with  dBASE  IV 
m  Iking  the  Menu  System 

u  Using  the  dBASE  TV  Applications  Generator 

m  Network  Installation ,  to  install  dBASE  IV  on  a  local  area  network. 

■  Language  Reference 

Experienced  dBASE  Users 

If  you’re  an  experienced  dBASE  user  but  want  to  know  more  about  this 
product,  you  can  read  the  following: 

■  The  dBASE IV Change  Summary,  to  find  out  the  differences  between  pre¬ 
vious  versions  of  dBASE  and  dBASE  IV. 

■  Using  the  dBASE  TV  Applications  Generator 
m  1b m plate  Language 
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■  Network  Installation,  to  install  dBASE  IV  on  a  local  area  network. 

■  Networking  with  dBASE IV,  to  create  multi-user  applications. 

■  Language  Reference 
m  Using  dBASE  IV  SQL 

Reading  “About  the  Manuals,"  below,  can  help  you  decide  now  which  learn¬ 
ing  path  best  suits  your  needs. 


About  the  Manuals 

Owners  of  dBASE  IV  Developer’s  Edition  can  purchase  additional  copies  of 
dBASE  IV  documentation.  See  the  enclosed  ordering  information. 

This  section  summarizes  the  topics  covered  in  the  dBASE  IV  Developer's 
Edition  documentation. 

Guide  to  dBASE  IV Developer’s  Edition  fold-out  card 

This  card  suggests  paths  you  can  follow  when  first  using  dBASE  IV  Develop¬ 
er’s  Edition  documentation. 

Customer  Support  Guide 


This  booklet  describes  the  Ashton-Tate  Support  Services  you  can  use  if  you 

have  trouble  installing  or  using  your  dBASE  IV  software.  It  includes  the  o 

AshtonTate  Software  Support  Center  telephone  number. 

dBASE  IV  Change  Summary 

This  booklet  lists  all  commands  and  functions  that  have  been  added  or  modi¬ 
fied  since  dBASE  I^PLUS.  In  addition,  it  provides  an  overview  of  dBASE  IV 
features. 


Using  the  Menu  System 

This  manual  is  a  reference  guide  for  dBASE  IV*s  menu  system ,  which  shows 
you  how  the  Control  Center  puts  you  in  control  of  the  power  of  dBASE  IV. 
The  menu  system  combines  pi  11-down  menus  with  foll-ecreen  graphic  inter¬ 
faces,  offering  you  fast  and  powerful  ways  to  create  database  files,  forms, 
reports,  or  labels.  You  can  also  use  the  menu  system  to  write  programs, 
manage  your  files,  or  customize  your  own  version  of  dBASE  IV.  The  menu 
system  is  available  from  both  the  Control  Center  and  the  dot  prompt. 

Network  Installation 

This  booklet  describes  how  to  install  dBASE  IV  as  a  multi-user  system.  It 
also  describes  the  Access  Control  Program,  which  you  use  to  add  to  or  sub¬ 
tract  from  the  number  of  users  who  can  access  dBASE  IV  on  *  local  area 
network. 


GS-16 


GETTING  STARTED  WITH  dBASE  IV  DEVELOPER'S  EDITION  -  DOS  VERSION 


jOBNAflE:  PACE:  17  SESS:  3  U«d  n.v  18  18  :  09  :  38  1  988 

It  ■  t «/d  i  *k2/ •  I  I  j  obx/CLS /GRP_^i«nh«t  /  J08_/n«og«t*  t/OI  V_gam»g  i  c 
Networking  with  dBASE  IV 


Thi»  manual  tells  you  how  to  manage  dBASE  IV  on  a  local  area  network  and 
write  network  applications.  You  learn  the  differences  between  single-user 
and  network  versions,  of  dBASE  application  programs,  how  to  create  pro¬ 
grams  for  shared  applications,  and  how  to  protect  shared  database  and  index 
files.  This  manual  is  for  the  network  user,  application  programmer,  and  net¬ 
work  administrator. 

Iking  the  dBASE  IV Applications  Generator 

The  Applications  Generator  acts  as  an  intermediary  between  you  and  the 
power  of  dBASE  IV  progran^ng.  Using  it,  you  can  have  dBASE  IV  write  pro¬ 
grams  that  automate  repetitive  tasks.  Even  if  you’re  not  a  programmer,  you 
can  create  easy-to-jise,  menu-driven  programs  that  simplify  your  database 
management  tasks. 

Using  dBASE  IV  SQL 

This  manual  shows  you  how  to  use  and  program  with  the  SQL  (Structured 
Query  Language)  commands  provided  by  dBASE  IV.  SQL  includes  a  compact 
set  of  commands  you  can  use  to  define,  query,  and  update  database  files. 

Quick  Reference 

This  book  is  a  concise  reference  to  the  dBASE^pommands,  functions,. a  a— 
waniiansT>ystem  memory  variables,  and  cursor  movement  keys.  It  also 
includes  SQL  commands  and  functions. 

Programming  with  dBASE  IV 

This  manual  covers  the  essentials  of  writing  good  programs  in  dBASE  IV, 
providing  you  with  numerous  tips  and  bints.  It  shows  you  how  to  analyze 
and  break  up  a  programming  project  into  simpler,  logical  tasks,  write  the 
code  to  perform  each  task,  and  then  test  and  debug  the  code.  A  sample 
inventory  program  is  used  to  demonstrate  concepts.  Your  Samples  Disk  con¬ 
tains  a  working  copy  of  the  program. 

Sample  Programming  Code 

This  booklet  contains  the  code  for  the  sample  applications  provided  with 
dBASE  IV.  dBASE  IV  programmers  of  all  levels  will  find  it  useful  to  scan  this 
code  for  programming  ideas  and  techniques. 

RunTime  and  Utilities 

In  this  booklet  you’ll  find  most  of  the  information  you  need  to  create  profes¬ 
sional  applications.  With  the  information,  you  can  modify  dBASE  IV 
programs  in  preparation  for  distributing  them.  This  manual  describes  how 
to  use  the  linker  and  build  utilities  provided  with  dBASE  IV  Developer’s 
Edition. 

1b m plate  Language 

This  booklet  provides  introductory  and  reference  material  on  the  template 
programming  language,  and  includes  a  walk-through  of  the  documentation 
template.  It  also  provides  information  on  the  syntax  of  the  language,  and 
command,  function,  and  selector  definitions.  A  knowledge  of  dBASE  IV  and 
Applications  Generator  is  assumed. 
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This  is  an  alphabetical  reference  to  all  dBASE  commands,  fonctions,  and  sys¬ 
tem  memory  variables,  containing  general  information  about  dBASE  IV*s 
capabilities.  In  addition,  this  reference  includes  a  chapter  on  configuration 
and  appendixes  on  error  messages  and  other  technical  subjects. 


Starting  dBASE  IV 

Follow  these  steps  to  start  dBASE  IV: 

1.  TUrn  on  your  microcomputer,  if  it's  not  already  on. 

OR,  if  your  microcomputer  is  already  on  and  you’re  continuing  from  the 
installation,  reset  the  microcomputer  by  holding  down  the  Ctrl  and  Alt 
keys,  and  pressing  the  Dal  key. 

This  resets  your  microcomputer  so  it  reads  the  new  Config.sys  file. 

2.  At  the  C>  prompt,  type  DBASE 

The  dBASE  copyright  notice  appears,  followed  by  the  Control  Center. 


NOTE 

dBASE  IV  tutoattictlly  starts  up  at  the  Control  Center.  If  you  prefer 
the  program  to  start  at  the  dot  prompt,  you  need  to  modify  th%  Con - 
Gg.db  file.  Remove  the  line  that  says  COMMAND -  ASSIST,  or  change 
the  word  ASSIST  to  another  dBASE  TV  command. 


Quitting  dBASE  IV 

Never  turn  off  or  reboot  your  computer  without  properly  exiting  from 
dBASE  IV.  Otherwise,  any  files  you  have  open  may  be  damaged.  If  you  want 
to  leave  dBASE  IV,  here’s  how: 

■  From  the  Control  Center,  press  F10  to  display  the  menu  options,  open 
the  Exit  menu,  and  select  Quit  to  DOS. 

OR 

■  From  the  dot  prompt,  type  QUIT**. 

Either  method  closes  any  flies  you  have  open  and  returns  you  to  the  operat¬ 
ing  system. 
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Implementing  dBASE  Security 

dBASE  IV  provides  three  different  levels  of  dBASE  security:  password,  file, 
and  record.  After  you  have  installed  dBASE  IV,  you  can  implement  password 
security  using  the  PROTECT  command,  which  limits  database  access  to  users 
who  can  enter  a  valid  log-in  name,  group  name,  and  password. 

After  you  have  installed  dBASE  IV  and  created  at  least  one  database  file,  you 
can  implement  both  file  and  record  security.  Refer  to  the  “dBASE  Security© 
chapter  in  Advanced  Tbpics  to  learn  more  about  these  levels  of  security  and 
to  decide  which  levels,  if  any,  you  need. 


Backing  Up  Database  Files 

You  are  encouraged  to  use  the  DOS  BACKUP  command  frequently,  or 
another  backup  utility,  to  make  backup  copies  of  your  database  files.  A 
backup  moves  data  from  your  hard  disk  to  diskettes,  or  to  a  tape  storage 
device.  Should  anything  unfortunate  occur  that  makes  the  data  on  your  hard 
disk  inaccessible,  you  can  use  the  DOS  RESTORE  command  to  copy  the 
backed-up  database  files  to  your  hard  disk.  See  your  DOS  manual  for  instruc¬ 
tions  on  using  BACKUP  and  RESTORE. 
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Introduction 


This  manual  describes  how  to  install  dBASE  IV  on  a  local  area  network 
(LAN).  If  you  are  new  to  local  area  networks  and  using  dBASE  IV,  you 
should  read  about  the  basic  capabilities  of  LAN  environments  in 
Advanced  Ibpics.  Users  of  dBASE  IV  Developer’s  Edition  should  refer  to 
Networking  with  dBASE  IV. 


.  Networks  Supported 

You  can  use  dBASE  IV  with  the  following  networks: 

AT&T  STARLAN  -  version  1.2 

IBM  PC  Net  —  version  1.2  or  later,  including  Token-Ring 
Novell*  SFT™  NetWare*  286  with  TTS  —  version  2.1 
Ungermann-Bass  Net/One*  PC  System  —  version  15.2 
3Com*  3  +  •  Share  Software  —  version  1.2 

Before  you  install  dBASE  IV  on  your  local  area  network,  you  must  first 
install  your  network  operating  system  software  following  the  appropriate 
manufacturer’s  network  administration  manual(s). 


About  This  Manual 

Network  Installation  is  written  for  those  persons  who  must  plan,  install,  and 
add  users  to  a  local  area  network. 

Chapter  1,  “Network  Planning,”  introduces  the  following  programs  and  com¬ 
mands  used  in  a  LAN  environment:  multi-user  dBASE  IV,  Adduser,  and  PRO¬ 
TECT.  This  chapter  also  describes  the  hardware  and  software  required  for 
running  multi-user  dBASE  IV  in  a  LAN  environment  and  discusses  planning 
considerations. 

Chapter  2,  “dBASE  IV  Installation,”  describes  how  to  install  multi-user 
dBASE  IV. 

Chapter  3,  “The  Access  Control  Program,”  describes  the  procedures  you 
follow  to  add  users  to  the  local  area  network. 
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The  seven  appendixes  are  as  follows: 

■  Appendix  A  lists  error  messages  specific  to  dBASE  IV  installation  and  the 
Access  Control  Program.  Following  each  message  is  an  explanation  of  its 
meaning  and,  where  appropriate,  corrective  user  action. 

■  Appendix  B  describes  dBASE  IV  installation  on  an  AT&T  STARLAN 
NETWORK. 

■  Appendix  C  describes  dBASE  IV  installation  on  an  IBM  PC  network. 

■  Appendix  D  describes  dBASE  IV  installation  on  an  IBM  Token-Ring 

network. 

■  Appendix  E  describes  dBASE  IV  installation  on  a  Novell  network. 

■  Appendix  F  describes  dBASE  IV  installation  on  an  Ungermann-Bass 

network. 

■  Appendix  G  describes  dBASE  IV  installation  on  a  3Com  3  +  network. 

This  manual  ends  with  a  thorough  index,  to  help  you  quickly  look  up  a 

specific  term  or  concept. 
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Network 

Planning 


About  This  Chapter 

This  chapter  provides  information  about  managing  dBASE  IV  on  a  local  area 
network  (LAN).  It  discusses  the  following  topics,  which  enable  you  to  use 
dBASE  IV  in  a  LAN  environment: 

■  Multi-user  dBASE  IV,  an  enhanced  version  of  single-user  dBASE  IV 

■  Adduser,  the  Access  Control  Program 

■  PROTECT,  a-security  command 

■  Network  hardware  and  software  requirements 

■  The  impact  of  dBASE  on  network  performance,  and  the  impact  of  net¬ 
working  on  application  programming  techniques 

dBASE  IV  adapts  to  your  networking  requirements  —  you  determine  the 
best  way  to  install  and  use  these  components.  Be  especially  aware  that: 

■  You  must  install  multi-user  dBASE  IV  on  a  file  server 

■  The  Access  Control  Program  controls  the  maximum  number  of  dBASE 
users  on  the  network 

■  PROTECT  is  optional 


dBASE  Network  Programs 

Multi-User  dBASE  IV 

This  version  of  dBASE  IV  allows  access  by  all  the  users  in  a  LAN  environ¬ 
ment.  It  includes  additional  commands  and  a  security  feature.  These  allow 
several  users  to  access  the  same  database  files,  but  still  ensure  the  integrity 
and  security  of  the  data  in  those  files. 

Single-user  and  multi-user  dBASE  IV  are  compatible.  All  dBASE  IV  files  and 
application  programs  created  in  single-user  dBASE  IV  are  compatible  in  the 
network  environment.  Likewise,  a  dBASE  IV  application  that  contains 
network-specific  features  can  be  run  in  a  single-user  environment.  Any  net¬ 
work  features  are  simply  ignored. 
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The  most  important  requirement  for  a  network  data  management  system  is 
that  it  enable  more  than  one  user  to  modify  the  same  database  file  at  what 
seems  to  be  the  same  time.  Actually,  it  performs  the  updates  one  after 
another,  so  that  data  is  not  lost  and  indexes  are  not  corrupted. 

dBASE  IV  offers  four  levels  of  protection  against  simultaneous  access  to  data 
in  a  network  environment:  locking  of  shared  files,  locking  of  shared  records, 
exclusive  use  of  files,  and  transaction  processing.  These  database  integrity 
tools  are  available  through  multi-user  dBASE  IV  commands  and  functions. 


Adduser 


This  program  controls  the  number  of  users  who  can  access  multi-user 
dBASE  IV  at  the  same  time.  When  you  install  multi-user  dBASE  IV,  one  user 
is  automatically  enabled  to  run  dBASE  IV.  The  Adduser  program,  located  in 
the  same  directory  as  the  multi-user  dBASE  IV  program  files,  allows  you  to 
add  additional  users.  Each  Access  disk  (from  a  dBASE  IV  LAN  Pack)  allows 
you  to  add  up  to  five  more  users. 

The  Adduser  program  also  enables  you  to  reduce  the  number  of  users  that 
are  allowed  to  run  dBASE  IV,  and  to  list  the  current  number  of  users  able  to 
do  so.  A  separate  directory  (named  DBNETCTL.300)  is  created  during  multi¬ 
user  dBASE  IV  installation.  It  contains  files  which  are  used  to  keep  track  of 
the  current  number  of  workstations  that  can  run  dBASE  IV  on  the  network 
at  any  time. 

Before  running  multi-user  dBASE  IV,  you  must  make  the  multi-user 
dBASE  IV  and  DBNETCTL.300  directories  shareable  on  the  network.  Then, 
you  must  set  a  path  on  each  workstation  to  these  two  directories.  You  can  set 
an  additional  path  to  access  data  files  at  the  file  server.  Therefore,  you  don't 
need  to  store  any  files  on  the  workstation’s  local  hard  disk  or  floppy  disk. 

After  multi-user  dBASE  IV  is  installed,  workstations  operating  on  the  net¬ 
work  can  start  up  dBASE  IV.  As  many  users  as  were  added  with  the  Adduser 
program  are  allowed  to  simultaneously  run  dBASE  IV.  Workstation  users  can 
access  shared  data  and  program  files  on  the  file  server,  or  create  and  use 
files  stored  locally  at  the  workstation. 


PROTECT 

dBASE  IV  includes  PROTECT,  a  security  command  that  assures  database  pri¬ 
vacy.  PROTECT  creates  a  security  system  to  prevent  unauthorized  users  from 
tampering  with  database  files.  This  command  defines  dBASE  logins  for  users, 
controls  the  type  of  data  access  users  have,  and  determines  how  data  is 
stored  to  ensure  that  only  authorized  users  can  read  it.^ 

^  dBASE  IV  users  should  refer  to  “dBASE  Security”  in  Advanced  Tbpics ,  for  a 
complete  description  of  the  PROTECT  command.  Users  of  dBASE  IV 
Developer’s  Edition  should  refer  to  “dBASE  Security”  in  Networking  with 
dBASE  IV. 

Use  of  this  command  is  optional.  Once  you  use  PROTECT,  however,  it  con¬ 
trols  all  access  to  the  dBASE  IV  system. 

You  can  use  PROTECT  in  a  single-user  environment  or  multi-user 
environment. 
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Network  Hardware  and  Software  Requirements 

File  Server  and  Workstations 


The  file  server  and  workstation  computers  which  run  dBASE  IV  must  be 
100%  IBM  PC  compatible.  Microcomputers  on  the  network  must  be  running 
DOS  3.1  or  greater,  and  must  also  be  running  the  network  program  (shell)  to 
access  directories  on  the  file  server  computer. 


RAM  Requirements 

The  file  server  computer  must  have  a  minimum  of  640K  RAM.  Each  work¬ 
station  also  requires  a  minimum  of  640K  RAM. 

Disk  Storage 


Your  file  server  computer  must  have  at  least  one  hard  disk  drive  and  one 
floppy  disk  drive  (or  one  3  1/2  inch  disk  drive  for  the  IBM  Personal 
System  12).  The  file  server's  hard  disk  must  have  approximately  660K 
available  to  install  multi-user  dBASE  IV  files.  It  also  should  have  enough 
room  for  workstation  files  you  want  to  maintain  with  multi-user  dBASE  IV. 
Workstations  do  not  need  any  hard  disk  storage  of  their  own,  but  one  work¬ 
station  must  have  a  floppy  disk  drive  for  dBASE  IV  installation. 

The  floppy  disk  drive  required  on  the  file  server  can  be  either  360K  or  1.2 
Mbyte.  dBASE  IV  is  supplied  both  on  diskettes  formatted  for  360K  floppy 
disk  drives  and  on  720K  3  1/2  inch  disks.  See  your  DOS  manual  for  a  discus¬ 
sion  of  disk  compatibility. 


El 


NOTE 


Your  network  may  have  additional  requirements  beyond  those  given 
here.  Check  your  network  documentation  for  specifics. 
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Application  Planning 

Here  are  several  points  to  consider  when  planning  how  to  use  dBASE  IV  and 

dBASE  IV  application  programs  on  a  network: 

1.  Study  the  impact  of  new  applications  and  application  programs  on  the 
network  before  making  them  generally  available.  Analyze  the  impact  in 
terms  of  both  network  performance  and  application/program 
performance. 

2.  Be  sure  that  you  and  the  network  users  always  place  different  tasks  in 
different  subdirectories.  Use  descriptive  names  for  the  subdirectories  so 
that  users  know  where  to  go  to  perform  a  specific  task  (for  example, 
DBASE  for  the  dBASE  subdirectory,  ACCOUNT  for  an  accounting  appli¬ 
cation  subdirectory).  Place  unrelated  applications  and  application  pro¬ 
grams  in  separate  subdirectories. 

3.  Check  out  the  response  time  on  the  network  when  the  application  is  up 
and  running.  If  an  application  adds  new  users  to  the  network,  examine 
the  effects  on  network  response  time. 

4.  Individually  tailor  the  dBASE  environment  for  each  workstation,  if  you 
wish,  by  placing  a  Config.db  file  in  the  log-in  directory. 

5.  Make  your  network  users  aware  of  the  implications  of  sharing  a  database 
with  other  users.  To  improve  program  performance,  see  that  your  net¬ 
work  application  programmers  are  aware  that  they  need  to: 

■  Place  non-shared  files  in  private  non-shared  volumes  or  in  local 
drives. 

■  Place  shared  network  files  in  shared  subdirectories. 

■  Access  database  files  from  a  program  file  rather  than  in  interactive 
mode.  Using  the  dot  prompt  to  access  database  files  lowers  the  con¬ 
currency  rate. 

■  Fully  test  an  application  program  before  making  the  application  avail¬ 
able  to  network  users.  An  untested  program  may  terminate  because  of 
a  simple  syntax  error. 

Testing  application  programs  is  especially  important  in  dBASE  IV 
transaction  processing.  If  program  errors  occur  while  several  users 
are  accessing  data,  partial  transactions  may  get  posted  and  cause 
unnecessary  havoc  unless  you  have  previously 
created  an  appropriate  ON  ERROR  program. 
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dBASE  IV 
Installation 


About  This  Chapter 

This  chapter  describes  how  to  use  the  Install  program  in  order  to  set  up  the 
multi-user  versions  of  dBASE  IV  and  dBASE  IV  Developer’s  Edition  on  a 
local  area  network. 


Before  You  Begin 

If  you  install  dBASE  IV,  the  Install  program  copies  the  following  programs 
and  related  Hies  to  your  hard  disk: 

Multi-user  dBASE  IV 

dBASE  IV  Applications  Generator 

dBASE  IV  Structured  Query  Language  (SQL) 

Config.db 

Sample  files  (optional) 

Tutorial  Hies  (optional) 

DBSETUP  (optional) 

After  you  install  dBASE  IV,  one  additional  network  user  will  be  able  to 
access  it.  To  allow  access  by  more  than  one  user,  use  the  Access  Control  Pro 
gram  and  an  Access  Disk  from  a  dBASE  IV  LAN  Pack. 

If  you  install  dBASE  IV  Developer’s  Edition,  the  Install  program  copies  the 
following  programs  and  related  files  to  your  hard  disk: 

Multi-user  dBASE  IV 

dBASE  IV  Applications  Generator 

dBASE  IV  Structured  Query  Language  (SQL) 

Config.db 

dBASE  IV  RunTime  (optional) 
dBASE  IV  Template  Language  (optional) 

Sample  Hies  (optional) 

DBSETUP  (optional) 

After  you  install  dBASE  IV  Developer’s  Edition,  three  additional  network 
users  will  be  able  to  access  dBASE  IV.  To  allow  access  by  more  than  three 
users,  use  the  Access  Control  Program  and  an  Access  Disk  from  a  dBASE  IV 
LAN  Pack. 
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Be  aware  of  the  following  considerations  when  installing  multi-user 
dBASE  IV: 

■  The  Install  program  is  very  flexible.  It  allows  you  to  copy  or  not  copy  all 
optional  files,  and  lets  you  change  the  drive  and  directory  in  which  files 
are  installed. 

■  Install  verifies  that  there  is  enough  space  on  a  specified  drive  before  it 
begins  to  copy  any  system  files  or  optional  files. 

■  You  need  not  create  any  directories  before  using  Install.  The  program 
creates  directories  for  you  during  the  installation  process,  or  you  can  use 
existing  directories  on  your  hard  disk. 

■  The  directory  containing  dBASE  IV  system  files  is  made  shareable 
automatically. 

■  The  dBASE  IV  system  files  are  made  read-only  and  shareable. 

■  The  installation  creates  a  sub-directory,  named  DBNETCTL.300,  to  the 
directory  that  contains  your  dBASE  IV  system  files. 

■  The  installation  does  not  modify  your  Autoexec.bat  and  Config.sys  files. 
See  the  appropriate  appendix  of  this  manual  for  information  about  the 
commands  that  should  be  in  these  files. 

You  install  multi-user  dBASE  IV  from  a  network  workstation  and  not  at  the 
file  server.  These  instructions  are  written  with  the  assumption  that  your 
workstation  starts  up  on  the  hard  disk.  Drive  A  refers  to  the  diskette  drive, 
and  drive  E  refers  to  the  hard  disk.  If  you  have  a  different  drive  letter  name 
for  your  hard  disk,  substitute  that  letter  for  E  in  these  instructions. 


WARNING 

If  you  want  to  have  both  single-user  and  multi-user  dBASE  IV  on 
your  hard  disk,  be  sure  to  install  them  into  separate  directories. 
Common  files  between  the  different  versions  will  conflict  with  each 
other  if  they  are  in  the  same  directory.  To  install  single-user 
dBASE  IV,  follow  the  instructions  in  your  Getting  Started  booklet. 


If  you  have  any  previous  version  of  dBASE  on  your  hard  disk,  you  have  two 
choices: 

■  To  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  To  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 
that  contains  it.  The  previous  version  will  be  automatically  deleted. 
(Your  data  files,  however,  will  be  left  intact.) 


2-2 


dBASE  IV  INSTALLATION 


JOBNAflE s  PAGE:  3  SEES:  U  Thu  n«y  19  00:  13:  03  1988 

®t  *t«/d  i  *K2/»I  I  j  obz/CLS_fn«nha  t  /GRP  jnenhet  /  JOB_jn«nn«  t  i  ns  t/DI  V_n  t  ch«o2 

Installing  dBASE  IV 

Tb  install  dBASE  IV  or  dBASE  IV  Developer’s  Edition  on  your  file  server, 

follow  these  steps: 

1.  Insert  the  Installation  Disk  in  drive  A  of  any  network 
workstation. 

2.  Make  drive  A  the  default  drive  by  typing  A:  ♦♦.  The  A>  prompt  appears 
on  the  screen. 

3.  Type  install  *-*.  After  a  few  seconds,  the  dBASE  IV  copyright  screen 
appears.  Press  —  to  continue. 

4.  Follow  the  prompts  that  appear  on  the  screen. 


Software  Registration 

Before  you  install  dBASE  IV  or  dBASE  IV  Developer’s  Edition  for  the  first 
time,  you  must  complete  the  Software  Registration  screen  to  identify  this 
copy  as  your  own. 

Enter  your  name,  your  company  name,  and  the  serial  number  from  System 
Disk  #  1.  Press  ♦♦  to  move  the  cursor  to  the  next  line  Press  Ctrl-End  to  save 
this  information.  The  information  you  enter  cannot  be  changed  after  you 
save  it. 


To  abandon  the  registration  screen  and  without  saving  the  registration  infor¬ 
mation,  press  Esc. 


NOTE 

Your  company  may  not  want  you  to  enter  your  name  on  the  Software 
Registration  screen.  Please  contact  the  appropriate  person  in  your 
company  for  any  special  instructions  on  completing  the  screen. 


dBASE  IV  installation  has  three  phases.  In  the  first,  you  describe  your  hard¬ 
ware  environment.  In  the  second,  you  specify  a  target  drive  and  directory, 
and  install  dBASE  IV  system  Files.  In  the  final  phase,  dBASE  IV  users  have 
the  option  to  copy  the  sample  files,  tutorial  files,  and  dBSETUP.  Users  of 
dBASE  IV  Developer’s  Edition  have  th  option  to  copy  dBASE  IV  RunTime 
files,  dBASE  IV  Template  Language  files,  the  sample  files,  and  DBSETUP. 


Hardware  Setup 

After  you  have  saved  the  information  entered  on  the  Software  Registration 
screen,  the  Hardware  setup  menu  appears. 

Use  this  menu  to  specify  whether  you  want  to  install  multi-user  dBASE  IV, 
the  display  mode  you  will  be  using,  whether  you  want  to  optimize  your  color 
display,  and  the  printers  you  will  be  using. 
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Multi-User  Installation 

Press  the  Spacebar  once  to  select  Yes  for  Multi-user  installation  and  press 
*♦.  The  cursor  moves  to  the  Display  mode  field. 

Display  Mode 

This  field  contains  the  following  options:  MONO,  M0N043,  COLOR, 

EGA25,  EGA43,  and  VGA25.  Press  the  Spacebar  to  cycle  through  the 
choices.  Press  ♦♦  to  select  the  display  mode  that  matches  your  default  moni¬ 
tor.  The  cursor  moves  to  the  Optimize  color  display  field. 

Optimize  Color  Display 

If  you  select  this  field  by  pressing  you  are  prompted  to  correct  a  “snow*'' 
effect  on  your  monitor. 

If  you  select  Cancel,  the  system  redisplays  the  Hardware  setup  menu.  If 
you  select  Proceed,  you  are  asked  if  you  see  a  “snow”  effect  on  your  moni¬ 
tor  right  now. 

If  you  see  snow  on  your  monitor,  press  *♦  or  Y.  Otherwise,  press  N  to  select 
No.  The  Hardware  setup  menu  reappears. 

Printers 

You  can  install  up  to  four  printer  drivers  in  addition  to  the  Ascii. pr2  and 
Generic.pr2  printer  drivers  which  are  installed  automatically.  If  you  do  not 
specify  any  printer  drivers,  dBASE  IV  uses  the  Generic. pr2  printer  driver.  If 
you  select  Printers  from  the  Hardware  setup  menu,  the  following  informa¬ 
tion  appears: 


Table  2-1  Printer  driv  er  selection 


Printer  name 


Printer  driver 


1.  Epson  LX -80/90  LX80.PR2 

2. 

3. 

4. 


Device 

LPT1 


This  table  lets  you  specify  up  to  four  printer  drivers  and  the  DOS  device 
assigned  to  each  printer.  The  first  entry  you  specify  in  the  table  contains  the 
default  printer  driver  and  device  used  with  dBASE  IV.  This  printer  name  will 
appear  on  the  Hardware  setup  menu. 
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To  select  printer  drivers  from  a  list,  press  Shift-FI  with  the  cursor  in  the 
Printer  name  column.  The  following  information  appears: 

Table  2-2  Printer  driver  list 


Printer  driver  Printer  name 

LX80.PR2  Epson  LX-80/90 


Press  Tabor  Shift-Tab  to  move  between  the  columns.  Tab  moves  the  cursor 
to  the  right  and  Shift-Tab  moves  the  cursor  to  the  left.  If  you  move  to  the 
outer  column,  the  next  Tabor  Shift-Tab w raps  around  to  the  opposite 
column. 

Press  Shift-FI  in  the  Printer  driver  column  to  display  a  list  of  printer  driver 
filenames.  As  you  scroll  through  either"column,  the  adjacent  box  indicates 
the  associated  driver  filename  or  printer  name,  depending  on  where  you 
press  Shift-  FI.  The  table  above  shows  the  list  and  adjacent  box  when  you 
press  Shift-FI  in  the  Printer  name  column.  If  you  move  the  cursor  to  a 
printer  name  in  the  list,  the  appropriate  printer  driver  filename  automati¬ 
cally  displays  in  the  Printer  driver  column.  Conversely,  if  you  move  the  cur¬ 
sor  to  a  printer  driver  filename  in  the  Printer  driver  column,  the  appropri¬ 
ate  printer  name  automatically  displays  in  the  Printer  name  column.  The 
selection  of  a  printer  name  uses  two  screens.  The  first  screen  lists  the  names 
of  the  printer  manufacturers.  The  second  lists  the  printer  models. 

To  enter  a  driver  name  not  displayed  in  the  Printer  driver  column,  simply 
type  the  appropriate  information  in  the  Printer  name  and  Printer  driver 
columns  of  the  first  table. 

The  Device  column  contains  the  following  options:  LPT1,  LPT2,  LPT3, 
COM1,  COM2,  \\SPOOLER,  and  \\CAPTURE.  Press  the  Spacebar  to  cycle 
through  the  choices.  The  first  device  you  select  will  be  the  default  or  startup 
device. 

When  you  have  selected  the  printer  names,  printer  drivers,  and  devices  for 
your  system,  press  Cut-End  to  save  this  information.  The  selected  printer 
drivers  will  be  copied  to  your  hard  disk  and  the  specified  devices  will  be 
assigned  to  the  specified  printers.  Press  Esc  to  exit  this  table,  abandon  all 
selections,  and  return  to  the  Hardware  setup  menu. 
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Installing  dBASE  IV  System  Files 

Before  the  dBASE  IV  system  files  are  installed,  you  are  given  the  chance  to 
verify  your  hardware  settings,  specify  the  hard  disk  drive  and  directory 
where  the  system  files  will  reside,  and  correct  other  conditions.  Some  of 
these  are:  insufficient  space  on  the  specified  disk,  the  target  directory  does 
not  exist,  the  target  directory  already  exists,  or  there  is  a  copy-protected  ver¬ 
sion  of  dBASE  in  the  target  directory. 

Hardware  Settings  Verification 

After  you  save  the  hardware  setup  information,  the  Install  program  tells  you 
that  you  are  ready  to  install  multi-user  dBASE  IV.  You  are  prompted  to  pro¬ 
ceed  with  the  installation,  modify  your  hardware  setup,  or  exit. 

Select  Proceed  to  install  multi-user  dBASE  IV,  Modify  hardware  setup  to 
return  to^the  Hardware  setup  menu,  or  Exit  to  leave  the  Install  program.  If 
you  select  Exit,  the  system  displays  the  exit  prompts  described  in  the 
“Exiting  Install”  section  near  the  end  of  this  chapter. 

Drive  and  Directory  Verification 

Before  you  start  the  installation  of  the  dBASE  IV  system  files,  you  are 
prompted  to  verify  the  drive  and  directory  in  which  to  install  them. 

The  cursor  is  under  the  character  at  the  far  left  of  the  field  (the  drive  letter). 
You  can  change  the  drive  and  directory  by  typing  at  your  keyboard.  Press  ♦♦ 
to  accept  the  default  drive  and  directory,  or  enter  the  correct  drive  and 
directory  and  press  ♦*. 

Correcting  Other  Conditions 

Before  the  installation  begins,  the  system  checks  the  following: 

1.  Is  there  enough  space  on  the  disk  that  contains  the  target  directory?  If 
not,  you  are  given  an  opportunity  to  reassign  the  target  drive. 

If  you  select  Exit,  the  standard  exit  prompts  appear.  If  you  select 
Change  drive,  you  are  prompted,  as  before,  to  verify  the  drive  and  direc¬ 
tory  in  which  to  install  the  dBASE  IV  system  files. 

Press  ♦♦  to  accept  the  default  drive  and  directory,  or  enter  the  correct 
drive  and  directory  and  press  *♦. 

2.  If  the  target  directory  does  not  exist,  the  system  will  create  it  for  you  or 
let  you  specify  a  new  drive  and  directory. 

If  you  select  Proceed,  the  Install  program  creates  the  directory  and  the 
installation  process  continues.  If  you  select  Change  drive/directory  or 
press  Eac,  you  are  prompted  to  enter  the  new  drive  and  directory. 

3.  If  multi-user  dBASE  IV  already  exists  in  the  target  directory,  the  system 
allows  you  to  overwrite  it,  exit  Install. 

If  you  select  Proceed,  the  dBASEAsystem  files  in  the  current  directory 
are  overwritten.  If  you  select  Change  drive/ directory  or  press  Eac,  you 
are  prompted  to  enter  the  new  drive  and  directory.  If  you  select  Exit, 
the  standard  exit  prompts  appear. 
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4.  If  a  multi-user  version  of  dBASE  III  PLUS  exists  on  your  network,  the  - — 

•  CA  J 

if  you  continue  with  the  installation.  *  / 4?  j  ** 

*1/11  A  1  f\  /  A 

If  you  select  Exit,  the  standard  exit  prompts  appear.  If  you  selec^ro-  ~£__ 
ceed,  the  system  informs  you  that  the  user  count  from  the  install'd  ver-  _  0,  c 

sion  of  dBASE  IV.  Press  any  key  to  continue.  ,  <AQA-S6  ^  ^  "u.' 

A  ai*+wt  3L+ 1  ca  1 1  y  Kret\-\A  - 

5.  If  the  system  detects  a  copy-protected  version  of  dBASE  in  the  specified  ^ 

target  directory,  you  must  either  specify  a  different  drive  and  directory 
or  use  the  Uninstall  program  provided  with  that  version  of  dBASE  before 
installing  dBASE  IV. 

If  you  select  Change  drive/ directory,  the  prompt  for  changing  the  tar¬ 
get  drive  and  directory  appears.  If  you  select  Exit,  the  system  gives  you 
the  exit  prompts  described  in  the  “Exiting  Install”  section  near  the  end 
of  this  chapter. 

6.  If  the  DBNETL.TL.300  subdirectory  cannot  be  created,  a  prompt  box 

appears  and  you  must  choose  between  installing  single-user  dBASE  IV  or 
exiting  Install.  The  system  attempts  to  create  the  DBNETCTL.300  subdi¬ 
rectory  before  copying  required  files.  Your  network  operating  system 
will  not  create  a  subdirectory  if  you  dojnot  have  the  proper  access  / 

rights.  Multi-user  dBASE  IV  will  not  be  installed  if  the  DBNETCTL.300 
subdirectory  cannot  be  created.  Refere  to  the  appropriate  appendix  in  e. 
this  manual  to  c^ate  the  proper  access  rights,  before  you  attempt  to  ^ 

install  multi-user  dBASE  IV. 

Select  Install  singlc-aser  to  install  single-user  dBASE  IV,  or  select  Exit 
to  end  the  installation. 


system  tells  you  that  you  willy 

fnotbeabletorundBASE  III  PLUS 
A  A  A  A  A 


Copying  System  Files 

After  the  system  determines  that  dBASE  IV  can  be  installed  in  the  target 
directory,  it  prompts  you  to  insert  the  dBASE  IV  system  disks  into  the  source 
drive. 


The  number  of  disks  that  you  insert  depends  on  whether  you  are  installing 
dBASE  IV  or  dBASE  IV  Developer’s  Edition,  and  the  size  of  your  disks7(5 
1/4- or  3  1/2-inch). 

Before  the  required  SQL  system  files  can  be  copied,  you  are  prompted  for 
the  drive  and  directory  in  which  to  install  them. 

Press  «-*  to  accept  the  default  drive  and  directory,  or  enter  the  correct  drive 
and  directory  and  press 

The  system  creates  the  directory  on  the  specified  drive  and  copies  the  follow 
ing  files  to  that  directory: 

■  A  master  (empty)  Sysdbs.dbf 

■  The  RunTime  .dbo  file  required  by  SQL 

■  A  full  set  of  empty  SQL  system  catalogs 


Z. 
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The  system  also  writes  the  following  statement  to  Config.db: 

SQLHOME-  <  path  > 

where  <  path  >  represents  the  specified  drive  and  directory  (for  example, 
C:\DBASE\SQLHOME)  for  the  SQL  home  directory. 

Copying  Config.db 

After  the  system  copies  the  SQL  files,  you  are  prompted  to  specify  the  drive 
and  directory  where  Config.db  will  reside. 

Press  *♦  to  accept  the  default  drive  and  directory,  or  enter  the  correct  drive 
and  directory  and  press  *♦. 

A  message  confirms  that  the  dBASE  IV  system  files  have  been  successfully 
installed.  In  addition,  you  are  prompted  to  install  other  files  or  exit  Install. 
Press  *♦  to  copy  other  files  to  your  hard  disk,  or  select  Exit  and  press 

Adding  Users 

After  you  install  Config.db,  the  system  prompts  you  to  add  more  users. 

Select  Add  user  to  call  the  Adduser4  program,  or  select  Skip  to  go  to  the 
next  step  in  the  installation  process  (copying  sample  files). 

If  you  select  Add  aser,  the  system  prompts  you  to  insert  an  Access  Disk  into 
your  disk  drive  and  to  enter  its  drive  letter.  The  system  shows  the  current 
user  count  and  asks  if  you  want  to  add  more  users  to  your  network.  Select 
Yes  to  add  another  user,  or  select  No  to  go  to  the  next  step  in  the  installa¬ 
tion  process  (copying  sample  files). 


Copying  Other  Files  —  dBASE  IV 

If  you  are  installing  dBASE  IV  Developer’s  Edition,  please  skip  to  “Copying 
Other  Files  —  dBASE  IV  Developer’s  Edition.” 

This  part  of  the  installation  allows  purchasers  of  dBASE  IV  to  optionally 
copy  dBASE  IV  sample  files,  tutorial  files,  and  DBSETUP. 

Copying  Sample  Files 

After  you  install  dBASE  IV  system  files  and  the  SQL  files,  you  are  prompted 
to  copy  the  sample  files. 

If  you  select  Skip,  the  program  goes  to  the  next  step  in  the  installation  pro¬ 
cess  (copying  the  tutorial  files).  If  you  press  Esc,  the  system  displays  the 
prompt  that  confirms  the  installation  (Muki-user  dBASE  IV  has  been 
installed  successfully).  If  you  select  Proceed,  you  are  prompted  to  confirm 
the  drive  and  directory  in  which  to  place  the  sample  files. 

The  default  directory  is  \DBASE\SAMPLES.  Press  *♦  to  accept  the  default,  or 
change  the  drive  and  directory  and  press  <•-».  If  you  press  Esc,  the  system  dis¬ 
plays  the  previous  prompt. 

After  you  press  *♦,  you  are  prompted  to  verify  the  specified  drive  and 
directory.  Press  ♦♦  to  accept  the  drive  and  directory  ,  or  select  Cancel  and 
press  ♦♦  to  display  the  previous  prompt. 
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If  there  is  not  enough  space  on  the  specified  drive  to  copy  the  sample  files, 
you  are  prompted  to  change  your  target  drive,  or  to  skip  the  sample  files 
installation. 

If  you  select  Change  drive,  the  prompt  for  entering  the  drive  and  directory 
appears  again.  If  you  select  Skip,  the  program  goes  to  the  next  step  in  the 
installation  process  (copying  the  tutorial  files). 

Install  creates  a  batch  file  called  Dbsamples.bat  and  places  it  in  the  dBASE 
directory.  This  batch  file  contains  the  following  commands: 

ECHO  OFF 
C: 

CD\DBASE\SAMPLES 
dBASE 

The  drive  and  directory  will  be  the  drive  and  directory  you  specify  for  the 
sample  files. 

After  the  system  copies  the  sample  files,  Install  will: 

■  Update  Sysdbs.dbf  in  the  SQL  directory  to  contain  the  name  of  the  sam¬ 
ple  database,  and  path  to  it  (\DBASE\SAMPLES). 

■  Place  SQLDAIABASE*  <  database  name>  in  Con  fig. db,  where 
<  database  name>  is  the  name  of  the  SQL  sample  database  (SAMPLES, 
by  default). 

If  you  decide  not  to  copy  the  sample  files,  SQLDATABASE-  will  not  be 
written  to  the  Config.db  file. 

Copying  Tutorial  Files 

See  the  previous  explanation  for  sample  files.  The  only  difference  is  the 
default  directory  (\DBASE\DBTUTOR). 

Copying  DBSETUP 

See  the  previous  explanation  for  sample  files.  The  default  directory  will  be 
the  dBASE  directory. 

If  the  Installation  Disk  cannot  be  found,  you  are  prompted  to  insert  it  into 
the  source  drive. 

Press  «-»  to  complete  the  installation,  and  skip  to  the  ‘‘Exiting  Install”  section 
later  in  this  chapter. 

Copying  Other  Res  —  dBASE  IV  Developer's  Edition 

If  you  are  installing  dBASE  IV,  please  refer  to  the  previous  section,  ‘‘Copying 
Other  Files  -  dBASE  IV.” 

This  part  of  the  installation  allows  purchasers  of  dBASE  IV  Developer’s  Edi¬ 
tion  to  optionally  copy  dBASE  IV  RunTime  files.  Template  Language  files, 
sample  files,  and  DBSETUP. 
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Copying  RunTime  Files 

After  Config.db  has  been  successfully  copied,  the  system  prompts  you  to 
install  the  RunTime  files.  Select  Skip,  if  you  do  not  want  to  copy  them.  If 
you  select  Proceed,  the  system  asks  you  to  insert  RunTime  Disk  #  n  into 
drive  A.  Select  Transfer  files  to  copy  the  files,  or  Cancel  to  return  to  the 
previous  prompt.  The  RunTime  files  are  copied  into  the  directory  that  you 
specified  for  the  dBASE  IV  system  files. 

Copying  Template  Language  Files 

After  you  copy  the  RunTime  files  (or  choose  to  skip  this  step),  the  system 
prompts  you  to  copy  the  dBASE  IV  Template  Language  toolkit. 

If  you  select  Skip,  Install  goes  to  the  next  step  (copying  sample  files).  If  you 
select  Proceed,  the  system  asks  you  to  insert  the  Template  Language  Disk 
into  drive  A.  Select  Transfer  files  to  begin  the  copying,  or  Cancel  to  return 
to  the,) 

C previous  prompt. 

If  you  choose  to  copy  the  Template  Language  toolkit,  the  system  asks  you  to 
enter  the  drive  and  directory  in  which  to  copy  these  files. 

The  default  directory  is  \DBASE\DTL.  Press  to  accept  the  default  drive 
and  directory,  or  enter  the  correct  drive  and  directory  and  press  *-►. 

Copying  Sample  Files 

After  you  install  the  dBASE  IV  Template  Language  files  (or  choose  to  skip 
this  step),  the  system  prompts  you  to  copy  the  sample  files. 

If  you  select  Skip,  the  program  goes  to  the  next  step  in  the  installation  pro¬ 
cess  (copying  DBSETUP).  If  you  press  Eac,  the  system  displays  the  prompt 
that  confirms  the  installation  (Mnld-nser  dBASE  IV  has  been  installed  suc¬ 
cessfully).  If  you  select  Proceed,  you  are  prompted  to  confirm  the  drive  and 
directory  in  which  to  place  the  sample  files. 

The  default  directory  is  \DBASE\SAMPLES.  Press  ♦*  to  accept  the  default,  or 
change  the  drive  and  directory  for  the  \SAMPLES  subdirectory  and  press  *♦. 
If  you  press  Eac,  the  system  displays  the  previous  prompt. 

After  you  press  ♦♦,  you  are  prompted  to  verify  the  specified  drive  and  direc¬ 
tory.  Press  to  accept  the  drive  and  directory,  or  select  Cancel  and  press 
♦*  to  display  the  previous  prompt. 

If  there  is  not  enough  space  on  the  specified  drive  to  copy  the  sample  files, 
you  are  prompted  to  change  your  target  drive,  or  to  skip  the  sample  files 
installation. 

If  you  select  Change  drive,  the  prompt  for  entering  the  drive  and  directory 
appears  again.  If  you  select  Skip,  the  program  goes  to  the  next  step  in  the 
installation  process  (copying  DBSETUP). 
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Install  creates  a  batch  file  called  Dbsamples.bat  and  places  it  in  the  dBASE 
directory.  This  batch  file  contains  the  following  commands: 

ECHO  OFF 
C: 

CD\DBASE\SAMPLES 

dBASE 

The  drive  and  directory  will  be  the  drive  and  directory  you  specify  for  the 
sample  files. 

After  the  system  copies  the  sample  files,  Install  will: 

■  Update  Sysdbs.dbf  in  the  SQL  directory  to  contain  the  name  of  the  sam¬ 
ple  database,  and  path  to  it  (\DBASE\SAMPLES). 

■  Place  SQLDATABASE-  <  database  name>  in  Config.db,  where 

<  database  name>  is  the  name  of  the  SQL  sample  database  (SAMPLES, 
by  default). 

If  you  decide  not  to  copy  the  sample  files,  SQLDATABASE-  will  not  be 
written  to  the  Config.db  file. 

Copying  DBSETUP 

See  the  previous  explanation  for  sample  files.  The  default  directory  will  be 
the  dBASE  directory. 

If  the  Installation  Disk  cannot  be  found,  you  are  prompted  to  insert  it  into 
the  source  drive. 

Press  ♦*  to  complete  the  installation. 

Exiting  Install 

When  you  exit  Install,  you  can  transfer  control  to  DOS  or  to  DBSETUP.  The 
DBSETUP  program  includes  a  Config.db  editor.  See  the  Language  Reference 
manual,  Chapter  6,  for  information  on  how  to  edit  Config.db. 

You  are  prompted,  next,  to  exit  to  DOS  or  transfer  to  DBSETUP. 

If  you  select  Exit  to  DOS,  Install  exits  to  the  DOS  prompt.  If  you  select 
Transfer  to  DBSETUP,  Install  exits  to  the  first  item  in  the  Install  menu  in 
DBSETUP. 

If  you  cancel  the  installation  before  it  finishes,  a  prompt  appears  asking  you 
if  you  want  to  abandon  the  installation.  If  you  select  Yes  and  changes  were 
made  to  the  Hardware  setup  menu,  you  are  asked  if  you  want  to  save  those 
changes,  and  for  the  drive  and  directory  in  which  to  save  them. 
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Uninstalling  dBASE  IV 

To  uninstall  dBASE  IV,  select  Uninstall  dBASE  IV  from  the  DBSETUP 
menu.  You  are  prompted  to  enter  the  drive  and  directory  from  which  to 
uninstall.  The  default  is  the  current  DOS  drive  and  directory. 

If  you  press  Esc,  the  system  displays  the  Install  menu.  Press  ♦♦  to  accept  the 
drive  and  directory.  Uninstall  checks  for  the  existence  of  the  drive  and  direc¬ 
tory.  If  the  target  drive  or  directory  does  not  exist,  you  are  prompted  to 
change  the  drive  and  directory,  or  cancel  the  uninstall  process. 

If  you  select  Cancel  or  press  Esc,  the  system  displays  the  Install  menu.  If 
you  select  Change  drive/ directory,  the  prompt  for  entering  the  drive  and 
directory  appears. 

If  the  system  finds  the  specified  drive  and  directory,  Uninstall  checks  to  see 
if  dBASE  IV  exists  in  that  directory.  If  dBASE  IV  is  not  there,  you  are  asked 
if  you  would  like  to  change  the  drive  and  directory. 

If  you  select  No,  the  Install  menu  appears.  If  you  select  Yes  or  press  Esc, 
the  previous  prompt  appears. 

If  the  system  finds  the  drive  and  directory  and  it  contains  dBASE  IV, 

Uninstall  deletes  all  the  dBASE  IV  system  files.  Uninstall  also  checks  for 
empty  subdirectories  (below  the  dBASE  directory).  If  it  finds  an  empty  subdi¬ 
rectory,  it  prompts  you  to  remove  this  subdirectory  from  the  disk. 

This  process  continues  until  you  have  been  prompted  about  all  the  empty 
subdirectories  below  the  dBASE  directory. 

When  the  uninstall  process  is  complete,  a  confirmation  messsage  appears, 
followed  by  a  prompt  to  return  to  the  Install  menu. 

Press  any  key  to  display  the  Install  menu.  You  can  then  exit  to  the  DBSETUP 
program  or  to  DOS  through  the  Exit  menu. 
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The  Access 

Control 

Program 


About  This  Chapter 


This  chapter  describes  the  Access  Control  Program,  the  program  you  use  to 
add  to  or  subtract  from  the  number  of  users  who  can  access  dBASE  IV  on  a 
Local  Area  Network  (LAN). 


Adding  Users 


Multi-user  dBASE  IV  automatically  enables  one  user  to  run 
dBASE  IV.  dBASE  IV  Developer’s  Edition  enables  three  users  to  run 
dBASE  IV.  To  enable  more  users  to  do  so,  you  need  to  run  the  Access  Con¬ 
trol  Program,  located  in  the  multi-user  dBASE  IV  directory.  You  can  add  five 
users  with  an  Access  Disk  from  the  dBASE  IV  LAN  Pack.  You  can  also  use 
System  Disk  #  1  or  dBASE  Access  disks  from  previous  versions  of  dBASE 
with  the  Access  Control  Program  to  add  one  user  from  each  disk. 


k  WARNING 

Users  cannot  be  logged  into  dBASE  IV  when  you  are  running  the 
Access  Control  Program. 


1.  Make  sure  you  are  in  the  directory  that  contains  the  multi-user  dBASE 
IV  program  files. 

2.  To  add  users  to  a  dBASE  IV  system,  type  ADDUSER4  and  press  *♦. 

3.  You  are  prompted  to  enter  the  drive  letter  where  the  control  files  in  the 
DBNETCTL.300  directory  are  located.  If  you  assigned  a  logical  drive  E  to 
the  drive  location  of  the  DBNETCTL.300  directory,  you  would  type  E 

4.  The  Access  Control  Program  screen  appears  (Figure  3-1). 
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Figure  3-1  Access  Control  Program  screen 

Thelfour  displayed  options  let  you  add  users,  subtract  users,  display  the  num¬ 
ber J>f  users  allowed,  and  exit. 

5.  Type  1  to  choose  the  Add  users  option.  You  are  prompted  to  enter  the 
floppy  disk  drive  letter  where  you  have  inserted  an  Access  disk.  When 
this  option  is  completed,  the  Access  Control  Program  screen  reappears. 

6.  Type  3  to  choose  the  Display  user  count  option.  This  option  lets  you  ver¬ 
ify  that  you’ve  added  one  user.  Follow  the  prompts  on  the  screen  to 
complete  the  procedure. 

7.  Repeat  step  5  for  each  user  you  want  to  add.  Remember  that  you  must 
use  a  System  Disk  #  1  not  previously  used  with  the  Add  users  option,  or 
an  Access  disk  from  a  dBASE  IV  LAN  Pack  which  has  not  added  its 
authorized  Access  counts. 

8.  Type  4  to  exit  the  Access  Control  Program. 

Record  the  file  server  name  on  each  disk  you  use  to  add  users. 


NOTE 

If  you  want  to  decrease  the  nu  tuber  of  users  who  can  access  multi¬ 
user  dBASE  IV,  you’ll  need  to  work  with  one  of  the  disks  you  origi¬ 
nally  used  to  add  a  user.  You  can  add  one  user  count  back  to  each 
System  Disk  *  1,  and  restore  five  user  counts  to  an  Access  disk.  Tb 
bring  the  number  of  users  down  to  zero,  you  must  uninstall  multi-user 
dBASE  IV.  For  details  on  how  to  decrease  the  number  of  users  able  to 
access  multi-user  dBASE IV,  see  the  “Subtracting  Users” section 
below. 
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Subtracting  Users 

1b  decrease  the  number  of  users  able  to  run  multi-user  dBASE  IV,  run  the 
Access  Control  Program  and  select  the  Subtract  users  option.  For  each  user 
you  want  to  subtract  from  the  current  number,  you  must  work  with  a  disk 
you  previously  used  to  add  a  user  to  this  network  (either  System  Disk  #  1  or 
an  Access  disk). 

Follow  these  steps: 

1.  Change  your  current  drive  to  the  directory  containing  the  multi-user 
dBASE  IV  program  Hies. 

2.  To  subtract  users  from  a  dBASE  IV  system,  type  ADDUSER4  and/press 

3.  You  are  prompted  to  enter  the  drive  letter  where  the  control  files  in  the 
DBNETCTL.300  directory  are  located.  If  you  assigned  a  logical  drive  E  to 
the  drive  location  of  the  DBNETCTL.300  directory,  you  would  type  E. 

4.  The  Access  Control  Program  screen  appears. 

3.  Type  2  to  choose  the  Subtract  users  option.  Follow  the  prompts  that 
appear  on  the  screen.  When  this  option  is  completed,  the  Access  Control 
Program  screen  reappears. 

6.  Type  3  to  choose  the  Display  user  count  option.  This  option  lets  you  ver¬ 
ify  that  you’ve  subtracted  one  user.  Follow  the  prompts  on  the  screen  to 
complete  the  procedure. 

7.  Repeat  step  5  for  each  user  you  want  to  subtract.  Remember  that  you 
must  work  with  a  disk  that  you  previously  used  to  add  users. 

8.  Type  4  to  exit  the  Access  Control  Program. 


NETWORK  INSTALLATION 


3-3 


JOBNAHE:  PAGE:  1  SESS:  4  U«d  flay  18  1  6  :  59:49  1  988 


•  t  a  t  e/d  i  sk2/«l  1  Jobz/CLS_manhat/GRP_m«nh«t/JOBjn»nnet  i  nst/OIV_ni  appa 

Error 

Messages 


This  appendix  alphabetically  lists  error  messages  that  can  appear  when 
using  the  Install  and  Access  Control  Programs.  Each  message  is  followed  by 
a  description  of  the  cause  of  the  error  and,  where  appropriate,  suggested 
corrective  action. 

For  error  messages  that  may  occur  when  you  run  single-user  dBASE  IV, 
refer  to  Appendix  Ain  the  Language  Reference  manual. 


Installation  and  Uninstallation  Messages 


Access  Control  Program  Messages 

The  following  messages  may  be  displayed  when  you  are  running  the  Access 
Control  Program: 

Control  file  name  not  found 

The  Access  Control  Program  cannot  locate  the  Dba.ctl  Hie  in  the 
DBNETCTL.300  directory.  The  file  may  be  corrupted. 

You  may  have  to  uninstall  dBASE  IV  and  then  reinstall  it. 

Invalid  drive  name 

You  need  to  enter  the  floppy  disk  drive  where  the  Access  disk  is  inserted,  to 
add  or  subtract  users. 

Invalid  network  id,  please  check  and  try  again 

You  need  to  specify  the  correct  drive. 

Invalid  serial  number 

The  floppy  disk  you  inserted  when  running  the  Access  Control  Program  to 
add  or  subtract  users  does  not  have  a  valid  serial  number. 

Invalid  system  disk 

The  disk  you’re  using  to  add  or  subtract  a  user  is  not  a  valid  dBASE  disk. 
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Lseek  failed  for  count  file 

The  Access  Control  Program  cannot  read  or  write  to  the  Dba.ctl  file,  located 
in  the  DBNETCTL.300  directory.  You  may  have  specified  the  wrong  drive,  or 
the  Dba.ctl  file  may  be  defective. 

You  may  have  to  uninstall  dBASE  IV  and  then  reinstall  it. 

Open  failed  for  count  file 

The  Access  Control  Program  cannot  open  the  Dba.ctl  file  located  in  the 
DBNETCTL.300  directory  because  another  user  is  running  the  Access^ton- 
trolProgram,  because  it  cannot  find  the  file,  or  because  restrictive  file 
access  privileges  have  been  set. 

Original  count  cannot  be  added  or  subtracted 

If  adding  a  user,  you  cannot  use  System  Disk  #  1  which  was  used  to  install 
dBASE  IV  (its  count  of  one  is  already  added);  if  subtracting  a  user,  you  can¬ 
not  reduce  the  user  count  to  zero  (unless  you  uninstall  dBASE  IV). 

Product  loader  cannot  be  opened 

The  Access  Control  Program  cannot  locate  or  open  the  file  Dba.com.  This 
may  occur  if  the  file  attributes  are  set  so  the  file  cannot  be  opened,  the  file  is 
not  located  by  a  DOS  PATH,  or  the  file  is  corrupted. 

Product  loader  cannot  be  read 

The  Access  Control  Program  cannot  read  the  Dba.com  file.  The  Dba.com  file 
may  be  corrupted. 

Read  failed  for  count  file 

The  Access  Control  Program  cannot  read  the  Dba.ctl  file  located  in  the 
DBNETCTL.300  directory  either  because  another  user  is  running  the  Access 
Control  Program,  or  because  restrictive  file  access  privileges  have  been  set. 

Read  failed  for  Serialization 

The  Access  Control  Program  cannot  read  the  file  on  the  floppy  disk  to  check 
the  serial  number  when  adding  or  subtracting  users.  The  disk  may  be^tiefec- 

tive. 

This  disk  has  already  been  added  to  the  network 

You  need  to  use  a  System  Disk  #  1  which  has  not  been  used  for  installation, 
or  to  use  an  Access  disk  with  user  counts  available. 

Write  failed  for  count  file 

The  Access  Control  Program  cannot  write  to  the  Dba.ctl  file  located  in  the 
DBNETCTL.300  directory  either  because  another  user  is  running  the  Access 
Control  Program,  or  because  restrictive  file  access  privileges  have  been  set. 
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AT&t 
STAR LAN 
NETWORK 
Information 


This  appendix  contains  information  for  users  who  are  about  to  install  multi¬ 
user  dBASE  IV  on  an  AT&T  STARLAN  NETWORK.  Read  through  each  sec¬ 
tion  before  following  the  installation  instructions  in  Chapter  2 


Before  You  Begin 

The  procedures  and  instructions  in  this  section  assume  the  following: 

■  You’ve  already  installed  your  STARLAN  NETWORK  and  have  also 
installed  the  network  program  software  on  each  computer  on  the 
network. 

■  You  are  familiar  with  AT&T  network  program  commands,  particularly 
the  Administrative  (AD),  File  Sharing  (FS),  and  Printer  Sharing  (PS) 
commands.  See  your  STARLAN  NETWORK  Uker’s  and  DOS  Server  Guide. 

■  You  are  operating  your  network  file  server  in  non-concurrent  or  dedi¬ 
cated  mode,  so  that  the  network  administrator  performs  all  operations 
from  a  workstation  (or  client )  computer. 


NOTE 

Run  the  Sle  server  in  dedicated  mode  when  you  install  dBASE  TV  on 
your  network.  The  memory  requirements  of  AT&Ts  network  program 
software  are  such  that  you  will  not  have  enough  free  memory  to  run 
multi-user  dBASE  IV  from  a  file  server  operating  as  a  client 
workstation. 


If  you  are  an  experienced  user  of  AT&T  STARLAN  NETWORKS,  turn  to  the 
“AT&T  STARLAN  Quick-Install  Guide”  at  the  end  of  this  appendix. 


Network  Requirements 

Read  your  STARLAN  NETWORK  User’s  and  DOS  Server  Guide  for  specific 
requirements  and  instructions  on  setting  up  client  workstations  and  file 
server  microcomputers.  Installing  dBASE  IV  requires  that  you’ve  already 
installed  the  CLIENT  or  FILE  SERVER  network  program  software  on  each 
workstation  you  use  when  running  dBASE  IV. 
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You  need  to  have  set  up  at  least  one  file  server  microcomputer  and  one  cli¬ 
ent  workstation  to  install  dBASE  IV. 

File  Server  and  Workstation  Requirements 

The  file  server  and  workstation  computers,  which  may  run  dBASE  IV,  can 
be  AT&T  6300,  AT&T  6300  PLUS,  or  other  100%  IBM  PC-compatible  comput¬ 
ers.  Computers  on  the  Local  Area  Network  (LAN)  must  be  running  MS-  or 
PC-DOS  3.1  or  greater,  and  must  also  be  running  the  network  program  to 
access  directories  on  the  file  server  computer. 


RAM  Requirements 

File  servers  and  workstations  must  have  a  minimum  of  640K  RAM. 


Disk  Storage 


■f=Upf>yAa.Uks 

^  lopf  I 

Checking  Config.sys  on  the  File  Server 

The  file  server  must  have  a  text  file  called  Config.sys.  This  file  must  be  in 
the  root  directory  of  the  drive  from  which  the  file  server  is  started  when  the 
computer  is  turned  on.  AT&Tr  network  program  installation  also  automati¬ 
cally  configures  this  file.  The  Config.sys  file  on  the  file  server  computer 
should  be  modified  to  contain  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 

The  file  server’s  Config.sys  file  has  two  other  settings,  one  for  LASTDRIVE 
and  one  for  DEVICE,  which  should  remain  in  the  file. 

To  edit  the  Config.sys  file,  use  the  DOS  EDLIN  utility  or  any  text  processor 
that  does  not  store  special  characters  in  the  file. 


Your  file  server  must  have  one  hard  disk  (with  at  least  10  Mbytes;  20  Mbytes 
for  an  AT&T  6300  PLUS)  and  one  disl^etto^rive  (360K  or  1.2  Mbyte).  The 
file  server’s  hard  disk  needs  at  least  800K  available  to  install  the  network 
program  software,  and  then  must  have  approximately  660K  available  to 
install  dBASE  IV  files,  the  network  version  of  dBASE  IV.  The  file  server’s 
hard  disk  should  also  have  enough  room  for  workstation  files  that  you  want 
to  store  on  the  file  server  for  use  with  dBASE  IV. 

Workstations  need  to  have  at  least  one  dio^ette^drive  to  boot  the  CLIENT^et- 
work  program  software.  The  diskette  drive  on  a  file  server  or  client  worksta¬ 
tion  can  be  either  360K  or  1.2  Mbyte.  dBASE  IV  is  supplied  on  diskette*  for¬ 
matted  for  360K  rives. 
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Checking  Config.sys  on  Each  Workstation  (Client) 

Each  workstation  or  client  com  puter  must  have  a  text  file  called  Config.sys. 
This  file  must  be  in  the  root  directory  of  the  drive  from  which  the  worksta¬ 
tion  is  started  when  the  computer  is  turned  on.  AT&T’s  network  program 
installation  automatically  configures  the  Config.sys  file  for  operation  on  the 
network.  To  take  maximum  advantage  of  dBASE  IV^s  multiple  file  handling 
capabilities,  you  may  need  to  modify  this  file. 

To  edit  the  Config.sys  file,  use  the  DOS  EDLIN  utility  or  any  text  processor 
that  does  not  store  special  characters  in  the  file. 

For  client  computers,  check  the  contents  of  the  file,  making  sure  it  contains 
the  following  settings: 

FILES  -  99 
BUFFERS  -  15 
LASTDRIVE  -  x 

where  x  is  a  valid  drive  letter  between  A  and  Z;  the  default  is  E.  Enter  the 
letter  that  corresponds  to  the  highest-lettered  logical  drive  you  plan  to  use. 


Installing  Multi-User  dBASE  IV 

Follow  the  instructions  in  Chapter  2  to  install  multi-user  dBASE  IV  on  your 
file  server.  Then,  follow  the  instructions  in  the  next  section  to  make 
dBASE  IV  shareable  on  the  network. 

If  you  have  a  previous  version  of  dBASE  on  your  hard  disk;  you  have  two 
choices: 

■  To  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  To  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 

•  that  contains  the  previous  version.  The  previous  version  will  be  automat¬ 
ically  deleted.  (Your  data  files,  however,  will  be  left  intact.) 

If  your  installation  attempt  fails,  the  following  documentation  may  provide 
additional  information: 

■  The  “Hardware  and  Software  Requirements”  section  in  your  Getting 
Started  booklet. 

■  The  DOS  manual  discussion  of  subdirectory  and  file  limitations;  for 
example,  limitations  on  the  number  of  files  in  a  subdirectory  and  the 
number  of  files  in  the  root  directory. 

■  Your  network  documentation,  for  corrective  action  if  a  network  error 
message  occurs. 

A  directory  named  DBNETCTL.300  is  also  created  during  multi-user 
dBASE  IV  installation.  This  directory  is  used  to  keep  track  of  the  number  of 
workstations  that  can  run  dBASE  IV  on  the  network  at  any  given  time.  Leave 
the  privileges  for  this  subdirectory  as  read/write,  to  allow  the  Access  Control 
Program  to  update  files.  Do  not  delete  this  directory  or  change  any  of  its 
contents. 
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WARNING 

A  file  named  Login. db  is  created  in  the  dBASE  IV  directory  the 
first  time  a  user  starts  up  dBASE  IV  on  a  network.  This  file  is  used 
with  the  DISPLAY  USERS  command  to  list  users  currently  running 
dBASE  IV.  If  you  run  multi-user  dBASE  IV  before  you  set  file  attri¬ 
butes  to  program  files,  do  not  make  file  privileges  for  the  Login. db 
file  read-only.  The  file  must  be  left  with  read/write  privileges  to 
allow  users  to  start  dBASE  IV. 


Making  dBASE  IV  Shareable  on  the  Network 

The  following  instructions  assist  you  in  creating  a  directory  called 
\APPS\DBASE  on  the  file  server’s  hard  disk.  The  instructions  assume  that 
you  are  at  a  client  workstation  and  are  linked  to  the  network  by  drive  D. 

1.  Log  in  as  the  network  administrator,  ADMIN: 

D>  AD  LOGIN  \\servername\ADMiN 

This  confirming  message  appears: 

Logged  in  to  \\servername\ADMIN 

2.  If  you  haven’t  already  created  a  directory  for  multi-user  application  pro¬ 
grams  on  your  file  server’s  hard  disk,  create  the  APPS  directory,  with  the 
sharename  APPS: 

D>  FS  ASHARE  APPS-  C:\APPS  — 

This  message  appears: 

\\serrername\C:APPS  shared  as  APPS 

3.  Next,  create  a  subdirectory  on  the  file  server’s  hard  disk,  APPS\DBASE, 
with  the  sharename  DBASE: 

D>  FS  ASHARE  DBASE-  C:\APPS\DBASE  — 

This  message  appears: 

\\serrername\C:\APPS\DBASE  shared  as  DBASE 

Creating  Shared  Database  and  Program  File  Directories 

While  you’re  still  logged  in  as  the  network  administrator,  create  any  other 
shared  directories  that  you  want  on  your  file  server.  For  example,  to  create  a 
shared  directory  DBFILES  on  the  file  server,  type: 

D>  FS  ASHARE  DBFILES  C:\DBFILES  — 

This  message  appears: 

\\scrrcrnaine\C:\DB FILES  shared  as  DBFILES 
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When  users  want  to  access  files  in  the  DBFILES  directory,  they’ll  link  a 
virtual  drive  to  this  directory. 


Starting  Multi-User  dBASE  IV 

After  multi-user  dBASE  IV  installation,  one  user  is  automatically  enabled  to 
run  dBASE  IV.  To  add  more  users,  you  need  to  run  the  Access  Control 
Program  (located  in  the  dBASE  IV  directory).  Users  run  multi-user 
dBASE  IV  from  a  workstation  by  first  linking  a  virtual  drive  to  the  dBASE  IV 
directory,  and  then  typing  the  DBASE  command  to  start  dBASE  IV 

1.  Log  in  to  the  workstation  with  the  username  you’ve  been  assigned  by 
your  network  administrator. 

C>  AD  LOGIN  \\servername\username  — ► 

Substitute  both  the  servername  and  the  username  you  are  using  in  this 
command. 

2.  Link  virtual  drives  to  the  dBASE  IV  directory  and  to  any  other  directo¬ 
ries  on  the  file  server  that  you  intend  to  use.  For  example: 

C>  FS  LINK  E:  DBASE  — 

C>  FS  LINK  F:  DBFILES  — 

NOTE 

You  should  also  set  up  linked  drives  in  a  DOS  search  path.  The  easi¬ 
est  way  to  do  this  is  to  add  the  linked  drives  to  the  PATH  command  set 
in  the  Autouser.bat  file.  For  example,  to  add  linked  drives  E?and  Ft? 
the  Path  command  would  be  set  to  contain  the  following: 

C>  PATH -  E\;F\  — 

1b  automatically  execute  the  Autouser.bat  file  each  time  the 
workstation  is  started  up,  add  a  command  line  in  the  workstation’s 
Autoexec.bat  file  to  execute  Autouser.bat. 

3.  Change  your  default  drive  and  directory  to  the  location  from  which  you 
want  to  run  dBASE  IV. 

4.  To  start  dBASE  IV,  type  the  following: 

C>  DBASE  — . 

Once  you’ve  entered  the  DBASE  command,  the  dBASE  IV  copyright 
notice  should  appear.  The  copyright  screen  includes  the  information  you 
entered  using  the  Install  program. 

Here’s  what  to  do  if  the  copyright  notice  doesn’t  appear: 

■  If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been 

PROTECTed.  dBASE  IV  users  should  refer  to  "Using  the  Network”  in 
Advanced  Tbpics ,  for  instructions  on  logging  into  a  PROTECTed  sys¬ 
tem.  Users  of  dBASE  IV  Developer’s  Edition  should  refer  to  “Using 
the  Network”  in  Networking  with  dBASE  IV. 
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■  If  any  other  message  appears,  refer  to  Appendix  A  for  a  listing  of  error 
messages  that  may  occur  when  running  dBASE  IV,  and  then  perform 
the  suggested  action. 

■  If  an  error  message  appears  that  isn’t  listed  in  Appendix  A,  check  for 
the  message  in  your  network  manual. 


Starting  an  Application  Program 

You  can  start  an  application  program  at  the  same  time  you  start  dBASE  IV, 
by  using  the  DBASE  command. 

Follow  the  DBASE  command  with  the  name  of  your  application  program 
using  the  following  syntax: 

D>  DBASE  [d:\path]  <  fiename>  *♦ 

For  [d:\path],  substitute  the  drive  and  directory  location  of  the  application 
program . 

For  <  filename  >  substitute  the  name  of  the  application  program  you  want 
to  run. 

For  example,  if  you  want  to  start  up  the  application  program  Myprog, 
located  in  the  same  directory  as  dBASE  IV,  you  would  type: 

D>  DBASE  E:MYPROG  — 

If  you  wanted  to  run  an  application  program  located  in  another  directory, 
for  example  the  DBFILES  directory  referenced  by  the  virtual  drive  F,  you 
would  type: 

D>  DBASE  F:MYPROG  — 

Creating  a  Batch  File  for  Starting 

You  can  simplify  the  process  of  starting  dBASE  IV  by  storing  the  PATH  and 
DBASE  commands  in  a  batch  file.  Type  the  following  commands  from  the 
DOS  prompt  to  create  a  batch  file  named  Dlan.bat  that  contains  the  informa¬ 
tion  you  enter  at  the  keyboard.  When  you’re  finished,  the  Dlan.bat  file  will 
be  stored  in  the  current  drive  and  directory. 

You  should  copy  the  batch  file  to  each  of  the  directories  from  which  you 
want  to  start  multi-user  dBASE  IV;  for  example,  your  home  directory  on  the 
network,  or  a  directory  on  your  workstation’s  local  hard  disk  drive. 

To  create  the  batch  file,  change  to  the  directory  in  which  you  want  to  store 
it,  and  type  the  following: 

D>  COPY  CON:  DLAN.BAT  — 

FS  LINK  E:  \\servername\DBASE  — 

FS  LINK  F:  \\servername\DBFILES  — 

DBASE  [d:\path]  <  filename  >  ♦♦ 

Ctri-Z  — 
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Using  the  directories  created  in  previous  examples,  you  can  link  the  logical 
drive  E  to  the  shared  multi-user  dBASE  IV  directory,  and  drive  F  to  the 
dBASE  program  and  database  file  directory. 

For  the  filename,  substitute  the  name  of  the  application  program  you  want  to 
run.  If  you  have  more  than  one  application  program  you  run  often,  you 
could  create  a  different  batch  file  for  each. 

Tb  run  the  batch  file  you’ve  created,  type: 


□  LAN  — 


dBASE  IV  users  should  refer  to  “Using  the  Network”  in  Advanced  Topics ,  for 
suggestions  on  what  to  do  after  starting  multi-user  dBASE  IV.  Users  of 
dBASE  IV  Developer’s  Edition  should  refer  to  “Using  the  Network”  \vl Net¬ 
working  with  dBASE  IV.  1 — 


AT&T  STARLAN  Quick-Install  Guide 


After  you  have  installed  dBASE  IV,  follow  these  steps  to  properly  configure 
the  network  for  use  with  dBASE  IV: 

1.  Check  the  contents  of  the  Config.sys  file  at  the  file  server  and  at  each 
workstation,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 

The  file  server  must  also  contain  a  LASTDRIVE-  x  statement,  where  x  is 
the  highest-lettered  logical  drive  you  plan  to  use. 

2.  Log  in  as  the  network  administrator,  ADMIN: 

D>  AD  LOGIN  \\servername\ADMIN  — 

3.  If  you  haven’t  already  created  a  directory  for  multi-user  application  pro¬ 
grams  on  your  file  server’s  hard  disk,  create  the  APPS  directory,  with  the 
sharename  APPS: 

D>  FS  ASHARE  APPS  -  C:\APPS 

4.  Finally,  create  a  subdirectory  on  the  file  server’s  hard  disk, 
APPS\DBASE,  with  the  sharename  DBASE: 

D>  FS  ASHARE  DBASE-  C:\APPS\DBASE  *-* 
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IBM  PC-Net 
Information 


Thi*  appendix  contains  information  for  users  who  are  about  to  install  multi¬ 
user  dBASE  IV  on  an  IBM  PC  network.  Read  through  each  section  before 
following  the  installation  instructions  in  Chapter  2. 


Before  You  Begin 


The  instructions  below  assume  your  file  server’s  hard  disk  drive  is  identified 
as  drive  C.  If  you  use  a  different  drive  designation,  substitute  that  letter  in 
the  instructions. 

If  you  are  an  experienced  user  of  IBM  PC  networks,  turn  to  the  “IBM  PC 
Network  Quick-Install  Guide”  at  the  end  of  this  appendix. 


Network  Requirements 


Read  your  IBM  PC  Network  Program  User’s  Guide  or  IBM  PC  Local  Area 
Network  Program  User’s  Guide ,  for  specific  requirements  and  instructions  on 
setting  up  workstations  and  file  server  microcomputers.  Installing  dBASE  IV 
on  an  IBM  PC  network  requires  that  you  use  the  IBM  PC  Net  program 
(Versionl.2)  and  install  one  Network  Adapter  Card  in  each  file  server  and 
workstation. 

The  network  file  server  must  have  a  minimum  of  640K  RAM.  The  RAM 
requirements  for  IBM  PC  network  workstations  are  as  follows: 

Minimum  workstation:  640K 
Messenger:  640K 
Receiver:  512K 
Redirector:  448K 


Checking  Config.sys  on  the  File  Server 


The  file  server  must  have  a  text  file  called  Config.sys.  This  file  must  be  in  the 
root  directory  of  the  drive  from  which  the  file  server  is  started  when  the 
computer  is  turned  on.  If  the  file  server  boots  from  drive  C,  for  example, 
Config.sys  must  be  in  the  root  directory  of  drive  C. 
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Config.sys  contains  instructions  to  configure  DOS  on  your  computer  (see 
your  DOS  manual).  To  take  maximum  advantage  of  dBASE  INfs  multiple  file 
handling  capabilities,  you  may  need  to  modify  this  file. 

To  edit  the  Config.sys  file,  use  the  DOS  EDLIN  utility  or  any  text  processor 
that  does  not  store  special  characters  (in  general,  control  characters  and/or 
printing  instructions)  in  the  file. 

Check  the  contents  of  the  file,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 
LASTDRIVE  -  x 

where  x  is  a  valid  drive  letter  between  A  and  Z;  the  default  is  E.  Enter  a  let¬ 
ter  corresponding  to  the  highest-lettered  logical  drive  you  plan  to  use.  (A 
logical  drive  associates  a  drive  letter  not  already  assigned  to  a  physical  disk 
with  a  directory  location  on  the  network.) 


NOTE 

7b  allow  each  workstation  user  to  open  as  many  files  as  possible  with 
dBASE  IV,  use  the  following  formula  to  determine  the  Files  setting: 


(Number  of  workstations  x  20)  +  20  -  Files  setting 


Other  application  programs  may  require  more  files  to  be  open.  Adjust 
your  Files  setting  accordingly.  The  maximum  Files  setting  is  99  per 
workstation. 


Checking  Corrfig.sys  on  Each  Workstation 

Each  workstation  must  also  have  a  Config.sys  file.  This  file  must  be  in  the 
root  directory  of  the  drive  from  which  the  workstation  is  started  when  the 
computer  is  turned  on. 

For  optimum  operation  of  multi-user  dBASE  IV  at  the  workstation,  check  the 
contents  of  the  Config.sys  file,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 
LASTDRIVE  -  x 

where  x  is  a  valid  drive  letter  between  A  and  Z;  the  default  is  E.  Enter  the 
letter  that  corresponds  to  the  highest-lettered  logical  drive  you  plan  to  use. 


Installing  Multi-User  dBASE  IV 

Follow  the  instructions  in  Chapter  2  to  install  multi-user  dBASE  IV  on  your 
file  server.  Then,  follow  the  instructions  in  the  next  section  to  make 
dBASE  IV  shareable  on  the  network. 
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If  you  have  any  previous  version  of  dBASE  on  your  hard  disk,  you  have  two 

choices: 

■  To  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  To  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 
that  contains  the  previous  version.  The  previous  version  will  be  automat¬ 
ically  deleted.  (Your  data  files,  however,  will  be  left  intact.) 

If  your  installation  attempt  fails,  the  following  documentation  may  provide 

additional  information: 

■  The  “Hardware  and  Software  Requirements”  section  in  your  Getting 
Started  booklet 

■  The  DOS  manual  discussion  of  subdirectory  and  file  limitations;  for 
example,  limitations  on  the  number  of  files  in  a  subdirectory  and  the 
number  of  files  in  the  root  directory 

■  Your  network  documentation,  for  corrective  action  if  a  network  error 
message  occurs 


A  directory  named  DBNETCTL.300  is  also  created  during  multi-user 
dBASE  IV  installation.  This  directory  is  used  to  keep  track  of  the  number  of 
workstations  that  can  run  dBASE  IV  on  the  network  at  any  given  time.  Leave 
the  privileges  for  this  subdirectory  as  read/write,  to  allow  the  Access  Control 
Program  to  update  files.  Do  not  delete  this  directory  or  change  any  of  its 
contents. 


WARNING 

A  file  named  Login. db  is  created  in  the  dBASE  IV  directory  the  first 
time  a  user  starts  up  dBASE  IV  on  a  network.  This  file  is  used  with 
the  DISPLAY  USERS  command  to  list  users  currently  running 
dBASE  IV.  If  you  run  multi-user  dBASE  IV  before  you  set  file 
attributes  to  program  files,  do  not  make  file  privileges  for  the 
Login. db  file  read-only.  The  file  must  be  left  with  read/write  privi¬ 
leges  to  allow  users  to  start  dBASE  IV. 
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Making  dBASE  IV  Shareable  on  the  Network 

Before  you  can  start  dBASE  IV,  you  need  to  make  the  DBASE  directory  and 
the  DBNETCTL.300  directory  (which  maintains  a  count  of  the  maximum 
number  of  dBASE  users)  shareable  on  the  network.  This  section  describes 
how  to: 

■  Assign  a  network  name  to  the  DBASE  directory,  provide  a  network  path 
to  locate  the  directory  on  the  network,  and  set  read,  write,  and  create 
access  privileges.  You’ll  also  assign  a  network  name  and  read  and  write 
privileges  to  the  DBNETCTL.300  directory. 

■  Assign  logical  drive  letters  to  the  network  path  locating  the  DBASE  and 
DBNETCTL.300  directories. 

Follow  these  steps: 

1.  From  the  file  server,  enter  the  following  NET  SHARE  command: 

C>  NET  SHARE  DBASE-  C:\DBASE  /RWC  — 

The  DBASE  directory,  with  the  privileges  /RWC,  has  now  been  given  the 
network  name  DBASE. 

2.  Then  type: 

C>  NET  SHARE  DBUSERS -  C:\DBNETCTL.300  /RWC  — 

The  DBNETCTL.300  directory  has  now  been  given  the  network  name 
DBUSERS. 

3.  On  the  workstation  from  which  you  want  to  start  multi-user  dBASE  IV, 
enter  the  following  NET  USE  command: 

A>  NET  USE  D:  \\servername\DBASE  — 

In  this  example,  the  NET  USE  command  associates  drive  letter  D  with 
the  network  name  DBASE.  Drive  D  is  also  referred  to  as  a  logical  drive. 
If  your  system  already  has  a  drive  D,  substitute  a  drive  letter  that  isn’t 
already  in  use.  For  the  servername  parameter,  substitute  the  network 
name  of  the  file  server. 

4.  On  the  same  workstation,  enter  this  command: 

A>  NET  USE  E:  \\servername\DBUSERS — 

Now,  the  network  name  DBUSERS  is  associated  with  logical  drive  E. 

To  avoid  retyping  these  commands,  add  the  commands  in  steps  1  and  2  to 
the  file  server’s  Autoexec.bat  file,  and  add  the  commands  in  steps  3  and  4 
to  the  Autoexec.bat  file  for  each  workstation.  See  your  DOS  manual  for 
instructions  on  setting  up  batch  files.  Check  your  network  program  manual 
for  requirements  for  the  file  server’s  Autoexec.bat  file. 
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Starting  Multi-User  dBASE  IV 

You  use  the  DBASE  command  to  start  up  multi-user  dBASE  IV  from  a  work¬ 
station.  You  can  also  start  multi-user  dBASE  IV  from  a  non -dedicated  file 
server;  however,  workstation  users  may  notice  the  network  runs  slower. 

Before  starting  multi-user  dBASE  IV,  your  DOS  path  must  be  set  to  the  two 
logical  drives  you  assigned  earlier  (this  example  continues  to  use  drives  D 
and  E). 

1.  Type: 

C>  PATH- D:\;E:\  — 

2.  Then  type: 

DBASE  ~ 

Please  note: 

■  If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been 
PROTECTed.  dBASE  IV  users  should  refer  to  “Using  the  Network”  in 
Advanced  Tbpics,  for  instructions  on  logging  into  a  PROTECTed  sys¬ 
tem.  Users  of  dBASE  IV  Developer’s  Edition  should  refer  to  “Using 
the  Network”  in  Networking  w ith  dBASE  TV. 

■  If  an  error  message  appears,  dBASE  IV  users  should  see  Appendix  A 
of  Advanced  Tbpics/fot  an  explanation  of  the  message  and 
recommended  corrective  actions.  Users  of  dBASE  IV  Developer’s 
Edition  should  see  Appendix  A  of  Networking  with  dBASE  TV. 

Starting  an  Application  Program 

You  can  start  an  application  program  at  the  same  time  you  start  up  multi¬ 
user  dBASE  IV.  Follow  these  steps: 

1.  Enter  the  path  statement: 

C>  PATH  -  D:\;E:\ 

2.  Follow  the  DBASE  command  with  the  name  of  your  application 
program: 

C>  DBASE  [d:\path] <  filename > 

For  [d:\path],  substitute  the  drive  and  directory  location  of  the  applica¬ 
tion  program. 

For  <  filename  >  ,  substitute  the  name  of  the  application  program  you 
want  to  run. 

For  example,  this  command  runs  the  application  program  Myprog  (in  the 
directory  G)  when  you  start  up  multi-user  dBASE  IV: 

C>  DBASE  G:\MYPROG~ 
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Creating  a  Batch  File  for  Starting 


You  can  simplify  the  process  of  starting  dBASE  IV  by  storing  the  PATH  and 
DBASE  commands  in  a  batch  file.  Type  the  following  commands  from  the 
DOS  prompt  to  create  a  batch  file  named  Dlan.bat  that  contains  the  informa¬ 
tion  you  enter  at  the  keyboard.  When  you’re  finished,  the  Dlan.bat  file  will 
be  stored  in  the  current  drive  and  directory. 

C>  COPY  CON:  DLAN.BAT  — 

PATH-  D:\;E:\  — 

DBASE  [[d:\path]  <  filename  >  ]  — 

Ctri-Z  — 

Please  note: 

■  The  first  line  creates  a  file  called  Dlan.bat. 

■  In  the  second  line,  D:\  and  E:\  represent  the  logical  drive  letters 
assigned  to  the  DBASE  and  DBNETCTL.300  directories. 

■  The  third  line  is  the  DBASE  command  you  use  to  start  multi-user 
dBASE  IV,  complete  with  an  optional  program  filename  and  path. 

■  The  fourth  line,  Ctri-Z  followed  by  — ,  closes  and  saves  the  batch  file. 

You  should  store  the  file  in  the  directory  from  which  you  normally  start 
dBASE  IV.  Then,  instead  of  typing  the  PATH  and  DBASE  commands,  simply 
type  DLAN  —  to  start  multi-user  dBASE  IV. 

If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been  PROTECTed.^ 
dBASE  IV  users  should  refer  to  “Using  the  Network”  in  Advanced  Topicsfiot 
suggestions  on  what  to  do  after  starting  multi-user  dBASE  IV.  Users  of 
dBASE  IV  Developer's  Edition  should  refer  to  “Using  the  Network”  in 
Networking  with  dBASE  IV. 


IBM  PC  Network  Quick-Install  Guide 


After  you  have  installed  dBASE  IV,  follow  these  steps  to  properly  configure 
the  network  for  use  with  dBASE  IV: 

1.  Check  the  contents  of  the  Config.sys  file  at  the  file  server  and  at  each 
workstation,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 

The  file  server  must  also  contain  a  LASTDRIVE-  x  statement,  where  x  is 
the  highest-lettered  logical  drive  you  plan  to  use. 

2.  Enter  the  following  commands  in  the  Autoexec.bat  file  at  the  file  server: 

C>  NET  SHARE  DBASE- C:\DBASE  /RWC  — 

C>  NET  SHARE  DBUSERS-  C:\DBNETCTL.300  /RWC  — 

3.  Enter  the  following  commands  in  the  Autoexec.bat  file  at  each 
workstation: 

A>  NET  USE  D:  \\servername\DBASE  — 

A>  NET  USE  E:  \\servername\DBUSERS  — 
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IBM 


Token-Ring 

Network 

Information 


This  appendix  contains  information  for  users  who  are  about  to  install  multi¬ 
user  dBASE  IV  on  an  IBM  Toicen-Ring  network.  Read  through  each  section 
before  following  the  installation  instructions  in  Chapter  2. 


Before  You  Begin 


The  instructions  below  assume  your  file  server’s  hard  disk  drive  is  identified 
as  drive  C.  If  you  use  a  different  drive  designation,  substitute  that  letter  in 
the  instructions. 

If  you  are  an  experienced  user  of  IBM  Token-Ring  networks,  turn  to  the 
“IBM  Token-Ring  Network  Quick-Install  Guide”  at  the  end  of  this  appendix. 


Network  Requirements 


Read  your  IBM  PC  Network  Program  User’s  Guide  or  IBM  PC  Local  Area 
Network  Program  User’s  Guide ,  for  specific  requirements  and  instructions  on 
setting  up  workstations  and  file  server  microcomputers.  Installing  dBASE  IV 
on  an  IBM  Token-Ring  network  requires  that  you  use  the  IBM  PC  Net  pro¬ 
gram  (Version  1.2)  and  install  one  Network  Adapter  Card  in  each  file  server 
and  workstation. 

The  network  file  server  must  have  a  minimum  of  640K  RAM.  The  RAM 
requirements  for  IBM  Token-Ring  network  workstations  are  as  follows: 

Minimum  workstation:  640K 
Messenger:  640K 
Receiver:  512K 
Redirector:  448K 


Checking  Conf  ig.sys  on  the  File  Server 


The  file  server  must  have  a  text  file  called  Config.sys.  This  file  must  be  in  the 
root  directory  of  the  drive  from  which  the  file  server  is  started  when  the 
computer  is  turned  on.  If  the  file  server  boots  from  drive  C,  for  example, 
Config.sys  must  be  in  the  root  directory  of  drive  C. 
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Config.sys  contains  instructions  to  configure  DOS  on  your  computer  (see 
your  DOS  manual).  To  take  maximum  advantage  of  dBASE  IVs  multiple  file 
handling  capabilities,  you  may  need  to  modify  this  file. 

To  edit  the  Config.sys  file,  use  the  DOS  EDLIN  utility  or  any  word  processor 
that  does  not  store  special  characters  (in  general,  control  characters  and/or 
printing  instructions)  in  the  file. 

Check  the  contents  of  the  file,  making  sure  it  contains  the  following  settings: 

FILES  -  80 
BUFFERS  -  15 
LASTDRIVE  -  x 

where  x  is  a  valid  drive  letter  between  A  and  Z;  the  default  is  E.  Enter  a  let¬ 
ter  corresponding  to  the  highest-lettered  logical  drive  you  plan  to  use.  (A 
logical  drive  associates  a  drive  letter  not  already  assigned  to  a  physical  disk 
with  a  directory  location  on  the  network.) 


NOTE 

1b  allow  each  workstation  user  to  open  as  many  Gles  as  possible  with 
dBASE  IV,  use  the  following  formula  to  determine  the  Files  setting: 


(Number  of  workstations  x  20)  +  20  «  Files  setting 


Other  application  programs  may  require  more  files  to  be  open.  Adjust 
your  Files  setting  accordingly.  The  maximum  Files  setting  is  99 per 
workstation. 


Checking  Config.sys  on  Each  Workstation 

Each  workstation  must  also  have  a  Config.sys  file.  This  file  must  be  in  the 
root  directory  of  the  drive  from  which  the  workstation  is  started  when  the 
computer  is  turned  on. 

For  optimum  operation  of  multi-user  dBASE  IV  at  the  workstation,  check  the 
contents  of  the  Config.sys  file,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 
LASTDRIVE  -  x 

where  x  is  a  valid  drive  letter  between  A  and  Z;  the  default  is  E.  Enter  the 
letter  that  corresponds  to  the  highest-lettered  logical  drive  you  plan  to  use. 
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Installing  Multi-User  dBASE  IV 

Follow  the  instructions  in  Chapter  2  to  install  multi-user  dBASE  IV  on  your 
file  server.  Then,  follow  the  instructions  in  the  next  section  to  make 
dBASE  IV  shareable  on  the  network. 

If  you  have  any  previous  version  of  dBASE  on  your  hard  disk,  you  have  two 
choices: 

■  To  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  To  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 
that  contains  the  previous  version.  The  previous  version  will  be  automat¬ 
ically  deleted.  (Your  data  files,  however,  will  be  left  intact.) 

If  your  installation  attempt  fails,  the  following  documentation  may  provide 
additional  information: 

■  The  “Hardware  and  Software  Requirements’’  section  in  your  Getting 
Started  booklet 

■  The  DOS  manual  discussion  of  subdirectory  and  file  limitations;  for 
example,  limitations  on  the  number  of  files  in  a  subdirectory  and  the 
number  of  files  in  the  root  directory 

■  Your  network  documentation,  for  corrective  action  if  a  network  error 
message  occurs 


dBASE  IV  Shareable  on  the  Network 

Before  you  can  start  dBASE  IV,  you  need  to  make  the  DBASE  directory  and 
the  DBNETCTL.300  directory  (which  maintains  a  count  of  the  maximum 
number  of  dBASE  users)  shareable  on  the  network.  This  section  describes 
how  to: 

■  Assign  a  network  name  to  the  DBASE  directory,  provide  a  network  path 
to  locate  the  directory  on  the  network,  and  set  read,  write,  and  create 
access  privileges.  You’ll  also  assign  a  network  name  and  read  and  write 
privileges  to  the  DBNETCTL.300  directory. 

■  Assign  logical  drive  letters  to  the  network  path  locating  the  DBASE  and 
DBNETCTL.300  directories. 

Follow  these  steps: 

1.  From  the  file  server,  enter  the  following  NET  SHARE  command: 

C>  NET  SHARE  DBASE- C:\DBASE  /RWC  — 

The  DBASE  directory,  with  the  privileges  /RWC,  has  now  been  given  the 
network  name  DBASE. 

2.  Then  type: 

C>  NET  SHARE  DBUSERS-  C:\DBNETCTL.300  /RWC  — 
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The  DBNETCTL.300  directory  has  now  been  given  the  network  name 
DB  USERS. 

3.  On  the  workstation  from  which  you  want  to  start  multi-user  dBASE  IV, 
enter  the  following  NET  USE  command: 

A>  NET  USE  D:  \\servername\DBASE 

In  this  example,  the  NET  USE  command  associates  drive  letter  D  with 
the  network  name  DBASE.  Drive  D  is  also  referred  to  as  a  logical  drive. 
If  your  system  already  has  a  drive  D,  substitute  a  drive  letter  that  isn’t 
already  in  use.  For  the  servername  parameter,  substitute  the  network 
name  of  the  file  server. 

4.  On  the  same  workstation,  enter  this  command: 

A>  NET  USE  E:  \\servername\DBUSERS  <•— 

Now,  the  network  name  DB  USERS  is  associated  with  logical  drive  E. 

To  avoid  retyping  these  commands,  add  the  commands  in  steps  1  and  2  to 
the  file  server’s  Autoexec.bat  file,  and  add  the  commands  in  steps  3  and  4 
to  the  Autoexec.bat  file  for  each  workstation.  See  your  DOS  manual  for 
..  instructions  on  setting  up  batch  Hies.  Check  your  network  program  manual 

for  requirements  for  the  file  server’s  Autoexec.bat  file. 


Starting  Multi-User  dBASE  IV 

You  use  the  DBASE  command  to  start  up  multi-user  dBASE  IV  from  a  work¬ 
station.  You  can  also  start  multi-user  dBASE  IV  from  a  non-dedicated  file 
server;  however,  workstation  users  may  notice  the  network  runs  slower. 

Before  starting  multi-user  dBASE  IV,  your  DOS  path  must  be  set  to  the  two 
logical  drives  you  assigned  earlier  (this  example  continues  to  use  drives  D 
and  E). 

1.  Type: 

C>  PATH=  D:\;E:\  ♦♦ 

2.  Then  type: 

DBASE  — 

Please  note: 

■  If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been 
PROTECIfed.  dBASE  IV  users  should  refer  to  “Using  the  Network”  in 
Advanced  Tbpicrf for  instructions  on  logging  into  a  PROTECTed  sys¬ 
tem.  Users  of  dBASE  IV  Developer’s  Edition  should  refer  to  “Using 
the  Network”  in  Networking  with  dBASE  IV. 

■  If  an  error  message  appears,  dBASE  IV  users  should  see  Appendix  A 
of  Advanced  Tbpicsjfot  an  explanation  of  the  message  and 
recommended  corrective  actions.  Users  of  dBASE  IV  Developer’s 
Edition  should  see  Appendix  A  of  Networking  with  dBASE  IV. 
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Starting  an  Application  Program 

You  can  start  an  application  program  at  the  same  time  you  start  up  multi¬ 
user  dBASE  IV.  Follow  these  steps: 

1.  Enter  the  path  statement: 

C>  PATH-  D:\;E:\  — 

2.  Follow  the  DBASE  command  with  the  name  of  your  application 
program : 

C>  DBASE  [d:\path]  <  filename >  ♦♦ 

For  [d:\path],  substitute  the  drive  and  directory  location  of  the  applica¬ 
tion  program . 

For  <  filename  >  ,  substitute  the  name  of  the  application  program  you 
want  to  run. 

For  example,  this  command  runs  the  application  program  Myprog  (in  the 
directory  G)  when  you  start  up  multi-user  dBASE  IV: 

C>  DBASE  G:\MYPROG  — 


Creating  a  Batch  File  for  Starting 

You  can  simplify  the  process  of  starting  dBASE  IV  by  storing  the  PATH  and 
DBASE  commands  in  a  batch  file.  Type  the  following  commands  from  the 
DOS  prompt  to  create  a  batch  file  named  Dlan.bat  that  contains  the  informa¬ 
tion  you  enter  at  the  keyboard.  When  you’re  finished,  the  Dlan.bat  file  will 
be  stored  in  the  current  drive  and  directory. 

C>  COPY  CON:  DLAN.BAT  — 

PATH-  D:\;E:\  — 

DBASE  [[d:\path]  <  filename >  ]  ♦♦ 

Ctrt-Z  — 

Please  note: 

■  The  first  line  creates  a  file  called  Dlan.bat 

■  In  the  second  line,  D:\  and  E:\  represent  the  logical  drive  letters 
assigned  to  the  DBASE  and  DBNETCTL.300  directories 

■  The  third  line  is  the  DBASE  command  you  use  to  start  multi-user 
dBASE  IV,  complete  with  an  optional  program  filename  and  path 

■  The  fourth  line,  Ctrl-Z  followed  by  **,  closes  and  saves  the  batch  file 

You  should  store  the  file  in  the  directory  from  which  you  normally  start 
dBASE  IV.  Then,  instead  of  typing  the  PATH  and  DBASE  commands,  simply 
type  DLAN  ♦♦  to  start  multi-user  dBASE  IV. 
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If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been  PROTECTed. 
dBASE  IV  users  should  refer  to  “Using  the  Network”  in  Advanced  Topics ,  for 
suggestions  on  what  to  do  after  starting  multi-user  dBASE  IV.  Users  of 
dBASE  IV  Developer’s  Edition  should  refer  to  “Using  the  Network”  in 
Networking  with  dBASE  IV 


IBM  Token-Ring  Network  Quick-Install  Guide 

After  you  have  installed  dBASE  IV,  follow  these  steps  to  properly  configure 
the  network  for  use  with  dBASE  IV: 

1.  Check  the  contents  of  the  Config.sys  file  at  the  file  server  and  at  each 
workstation,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS-  15 

The  file  server  must  also  contain  a  LASTDRIVE-  x  statement,  where  x  is 
the  highest-lettered  logical  drive  you  plan  to  use. 

2.  Enter  the  following  commands  in  the  Autoexec.bat  file  at  the  file  server. 

C>  NET  SHARE  DBASE- C:\DBASE  /RWC  — 

C>  NET  SHARE  DBUSERS  -  C:\DBNETCTL.300  /RWC  — 

3.  Enter  the  following  commands  in  the  Autoexec.bat  file  at  eachjworksta- 
tion: 

A>  NET  USE  D:  \\servername\DBASE 

A>  NET  USE  E:  \\servername\DBUSERS  — 
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Novell  Network 
Information 


This  appendix  contains  information  for  users  who  are  about  to  install  multi¬ 
user  dBASE  IV  on  a  Novell  SFT  NetWare  286  network.  Read  through  each 
section  before  following  the  installation  instructions  in  Chapter  2. 


Before  You  Begin 

The  procedures  and  instructions  in  this  section  assume  the  following: 

■  You’ve  already  installed  your  Novell  network,  and  the  Novell  SFT 
Netware  286  program  is  operating. 

■  You’re  familiar  with  Novell  SFT  NetWare  286  commands.  In  particular, 
you  know  how  to  use  the  MAP  command  and  the  SYSCON  menu  utility. 

■  The  default  drive  on  your  network  is  logical  drive  E  and  the  location  of 

a  multi-user  dBASE  IV  directory  is  mapped  to  a  logical  drive  F.  A  logical 
drive  associates  a  drive  letter  not  already  assigned  to  a  physical  disk  with 
a  directory  location  on  the  network.  If  your  network  setup  uses  different 
drive  designations,  substitute  those  letters  in  the  instructions. 

■  You  are  operating  in  non-concurrent  or  dedicated  mode,  so  that  the 
network  administrator  performs  all  operations  from  a  workstation. 

If  you  are  an  experienced  user  of  Novell  SFT  NetWare  286,  turn  to  the 
“Novell  Quick-Install  Guide”  at  the  end  of  this  appendix. 


Network  Requirements 

Installing  dBASE  IV  on  a  Novell  network  requires  that  you  use  Novell 
System  Fault  Tolerant  (SFT)  NetWare  286  (Version  2.1). 

Read  the  Novell  SFT  NetWare  286  Installation  manuals  for  specific  requirements 
and  instructions  on  setting  up  workstations  and  file  servers. 

You  must  install  one  network  interface  card  in  each  file  server  and  worksta¬ 
tion.  File  servers  and  workstations  on  the  network  must  have  a  minimum  of 
640K  RAM. 
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Checking  Config.sys  on  Each  Workstation 


Each  workstation  must  have  a  text  file  called  Config.sys.  This  file  must  be 
in  the  root  directory  of  the  drive  from  which  the  workstation  is  started  when 
the  computer  is  turned  on.  To  take  maximum  advantage  of  dBASE  IV’s  mul¬ 
tiple  file  handling  capabilities,  you  may  need  to  modify  this  file. 

To  edit  the  Config.sys  file,  use  the  DOS  EDLIN  utility  or  any  text  processor 
that  does  not  store  special  characters  (in  general,  control  characters  and/or 
printing  instructions)  in  the  file. 

Check  the  contents  of  the  file,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 

Your  dedicated  file  server  does  not  need  a  Config.sys  file. 


Installing  Multi-User  dBASE  IV 


Follow  the  instructions  in  Chapter  2  to  install  multi-user  dBASE  IV  on 
your  file  server.  Then,  follow  the  instructions  in  the  next  section  to  make 
dBASE  IV  shareable  on  the  network. 

If  you  have  any  previous  version  of  dBASE  on  your  hard  disk,  you  have  two 
choices: 

■  To  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  To  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 
that  contains  the  previous  version.  The  previous  version  will  be  automat¬ 
ically  deleted.  (Your  data  files,  however,  will  be  left  intact.) 

If  your  installation  attempt  fails,  the  following  documentation  may  provide 
additional  information: 

■  The  “Hardware  and  Software  Requirements”  section  in  your  Getting 
Started  booklet 

■  The  DOS  manual  discussion  of  subdirectory  and  file  limitations;  for 
example,  limitations  on  the  number  of  files  in  a  subdirectory  and  the 
number  of  files  in  the  root  directory 

■  Your  network  documentation,  for  corrective  action  if  a  network  error 
message  occurs 

A  directory  named  DBNETCTL.300  is  also  created  during  multi-user 
dBASE  IV  installation.  This  directory  is  used  to  keep  track  of  the  number  of 
workstations  that  can  run  dBASE  IV  on  the  network  at  any  given  time.  Leave 
the  privileges  for  this  directory  as  read,  write,  create,  open,  and  search,  to 
allow  the  Access  Control  Program  to  update  files.  Do  not  delete  this  direc¬ 
tory  or  change  any  of  its  contents. 


E-2 


JOBNAME :  PACE:  3  SESS:  4  Thu  H.y  19  09:  29:  34  1988 

■(  ata/d  i  sk2/a  I  l  j  obz/CLS.jn»nh«t  /GRP _jnanhat  /  JOB_manna  t  i  ns  t/OI  V_n  I  aop* 


WARNING 

A  file  named  Login. db  is  created  in  the  dBASE  IV  directory  the 
first  time  a  user  starts  up  dBASE  IV  on  a  network.  This  file  is  used 
with  the  DISPLAY  USERS  command  to  list  users  currently  running 
dBASE  IV.  If  you  run  multi-user  dBASE  IV  before  you  set  file  attri¬ 
butes  to  program  files,  do  nor  make  file  privileges  for  the  Login. db 
file  read-only.  The  file  must  be  left  with  read/write  privileges  to 
allow  users  to  start  dBASE  IV. 


Sharing  Directories 

After  installing  multi-user  dBASE  IV,  you  must  follow  these  instructions  to 
make  the  multi-user  dBASE  IV  directory  accessible  through  a  search  drive: 

1.  Log  in  as  SUPERVISOR  at  a  workstation. 

2.  Use  the  Novell  MAP  SEARCH  command  to  make  the 
SYS:DBNETCTL.300  directory  accessible  through  a  search  drive.  The 
DBNETCTL.300  directory  was  created  during  the  installation.  Type  the 
following: 

F>  MAP  SEARCH2:SYSDBNETCTL.300  ♦♦ 

Typically,  this  command  will  make  the  DBNETCTL.300  directory  avail¬ 
able  through  logical  drive  X.  You  can  check  the  drive  assignment  by 
typing  MAP(and  pressing)—*. 


NOTE 

The  MAP  SEARCH  command  operates  in  much  the  same  way  as  a 
combination  of  the  DOS  PATH  and  CD  commands.  It  assigns  a  net - 
work  drive  and  directory  in  which  to  search  for  files  not  in  the  current 
directory.  The  MAP  SEARCH  drive  remains  in  effect  while  you  are 
logged  in.  You  can  store  MAP  commands  in  a  log-in  script,  using  the 
log-in  script  created  in  SYS  CON.  That  way,  the  search  drive  assign¬ 
ments  will  be  set  up  each  time  you  log  in.  You  need  to  map  the 
DBASE  directory  for  each  workstation  running  dBASE  TV. 

3.  Use  the  MAP  command  to  assign  the  multi-user  dBASE  IV  directory  a 
logical  drive  letter.  If  you  have  installed  DBASE  in  a  directory  other  than 
DBASE,  substitute  that  directory  name  in  the  following  example: 

F>  MAP  F:-  SYS:DBASE  — 
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4.  Create  any  other  shared  or  private  directories  that  you  want  on  your  file 
server.  For  example,  to  create  a  directory  on  the  Hie  server  to  store 
application  programs  or  data  files  separate  from  multi-user  dBASE  IV 
files,  you  could  first  create  the  directory  SYS:DBFILES,  and  then  assign 
it  shared  access  privileges.  Then  you  would  use  the  MAP  command  to 
assign  the  directory  a  logical  drive  letter.  Type  the  following: 

F>  MAP  G:-  SYS:DBFILES  — 

You’ll  also  want  to  store  the  mapping  of  the  directory  to  a  logical  drive 
in  each  user’s  log-in  script. 


Making  Trustee  Assignments 

You  must  create  the  following  trustee  assignments.  The  trustee  assignments 
shown  below  without  asterisks  are  the  minimum  rights  needed  for  each 
directory.  Those  marked  with  asterisks  are  additional  rights  that  you  may 
assign  and  should  be  assigned  to  give  the  user  full  functionality  within 
dBASE  IV. 

SYS:DBNETCTL.300  READ 

WRITE 
OPEN 
SEARCH 

SYSrDBASE  READ 

OPEN 
SEARCH 
CREATE 
•WRITE 
•DELETE 
•PARENTAL 

SYSrDBASE/ SQLHOME  READ 

WRITE 
OPEN 
SEARCH 
PARENTAL 
DELETE 
CREATE 

SYS:DBASE/DBDATA  READ 

OPEN 
SEARCH 
CREATE 
•WRITE 
•DELETE 

An  easy  way  to  make  trustee  assignments  is  to  create  a  group  called  DBASE 
and  make  each  user  that  should  have  access  to  dBASE  IV  a  member  of  the 
group. 
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Starting  Multi-User  dBASE  IV 

Use  the  Novell  MAP  command  and  the  DBASE  command  to  start  multi-user 
dBASE  IV  from  a  workstation,  as  described  below.  Also  included  is  how  to 
set  up  each  workstation’s  log-in  script  to  identify  network  drive  and  directory 
locations  of  the  files  each  user  needs  to  access. 

1.  Add  these  MAP  SEARCH  commands  to  your  log-in  script  for  the  network 
location  of  the  DBNETCTL.300  directory.  Type  the  following: 

F  >  MAP  SEARCH2:  -  SYS:DBNETCTL.300  — 

F  >  MAP  F:  -  SYS:DBASE  — 

2.  Map  the  location  of  drives  and  directories  containing  application  pro¬ 
grams  and  shared  database  files,  as  well  as  directories  on  the  file  server 
that  are  private.  For  example,  you  could  specify  drive  H  as  the  location 
of  a  database  file  and  application  program  directory,  SYS:DBFILES,  by 
typing  the  following: 

F>  MAP  H:«  SYS:DBFILES  *♦ 

3.  To  start  multi-user  dBASE  IV,  type  F:  and  press  *■*.  Then  type  DBASE  and 
press  <•— . 

Once  you’ve  entered  the  DBASE  command,  the  dBASE  IV  copyright  notice 
should  appear.  The  copyright  screen  includes  the  software  registration  infor¬ 
mation  you  entered  during  installation. 

NOTE 

If  your  system  has  been  PROTECTbd,  you  must  enter  a  valid  user  login 
before  the  copyright  screen  appears. 


If  the  copyright  notice  doesn’t  appear  and  an  error  message  appears, 
dBASE  IV  users  should  refer  to  Appendix  A  of  Advanced  Tbpics  for  a  listing 
of  error  messages  that  may  occur  when  running  dBASE  IV,  and  then  take 
the  suggested  action.  Users  of  dBASE  IV  Developer’s  Edition  should  refer  to 
Appendix  A  of  Networking  with  dBASE  IV. 

Starting  an  Application  Program 

You  can  start  an  application  program  at  the  same  time  you  start  dBASE  IV 
by  using  the  DBASE  command. 

Follow  the  DBASE  command  with  the  name  of  your  application  program, 
using  the  following  syntax: 

F>  DBASE  [d:\path]  <  filename >  — 

For  [d:\path],  substitute  the  drive  and  directory  location  of  the  application 
program. 

For  <  filename  >  ,  substitute  the  name  of  the  application  program  you  want 
to  run. 
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For  example,  if  you  wanted  to  start  up  the  application  program  Myprog, 
located  in  the  same  directory  as  dBASE  IV,  you  would  type: 

F>  DBASE  MYPROG  — 

If  you  wanted  to  run  an  application  program  located  in  another  directory, 
for  example  the  SYS:DBFILES  directory  referenced  by  the  logical  drive  H, 
you  would  type: 

F>  DBASE  H:MYPROG  — 


Creating  a  Batch  File  for  Starting 

You  can  simplify  access  to  multi-user  dBASE  IV  by  storing  your  DBASE 
command  in  a  batch  file.  The  following  procedure  creates  a  batch  file 
named  Dlan.bat  that  contains  the  information  you  enter  at  the  keyboard. 
When  you’re  finished,  the  Dlan.bat  file  will  be  stored  in  the  current  drive 
and  directory. 

You  should  copy  the  batch  file  to  the  PUBLIC  subdirectory. 

To  create  the  batch  file,  change  to  the  directory  in  which  you  want  to  store 
it,  and  type  the  following: 

F>  COPY  CON:  DLAN.BAT  — 

DBASE  [d:\path)  <  filename  >  *♦ 

Ctrt-Z  — 

For  [d:\path],  substitute  the  drive  and  directory  location  of  the  application 
program. 

For  <  filename  >  ,  substitute  the  name  of  the  application  program  you  want 
to  run.  If  you  have  more  than  one  application  program  you  run  often,  you 
could  create  a  different  batch  Hie  for  each. 

To  run  the  batch  file  you’ve  created,  type: 

DLAN  — 

If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been  PROTECIfed., 
dBASE  IV  users  should  refer  to  “Using  the  Network”  in  Advanced  Topicsflox 
suggestions  on  what  to  do  after  starting  multi-user  dBASE  IV.  Users  of 
dBASE  IV  Developer’s  Edition  should  refer  to  “Using  the  Network”  in 
Networking  with  dBASE  IV. 
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After  you  have  installed  dBASE  IV,  follow  these  steps  to  properly  configure 
the  network  for  use  with  dBASE  IV: 

1.  Check  the  contents  of  the  Config.sys  file  at  each  workstation,  making 
sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 


Your  dedicated  file  server  does  not  need  a  Config.sys  file. 
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2.  Set  up  the  following  user  login  script  at  each  workstation: 

MAP  SEARCH2:-  SYS:DBNETCTL.300 
MAP  F:-  SYS:DBASE 
MAP  G:-  SYS:DBASE/DBDATA 
MAP  S:-  SYS:DBASE/SQLHOME 
DRIVE  F: 

#SPOOLL-  2  TI-  1 

3.  Create  the  following  trustee  assignments.  An  easy  way  to  do  this  is  to 
create  a  group  called  DBASE  and  make  each  user  that  should  have 
access  to  dBASE  IV  a  member  of  the  group.  The  trustee  assignments 
shown  below  without  asterisks  are  the  minimum  rights  needed  for  each 
directory.  Those  marked  with  asterisks  are  additional  rights  that  you  may 
assign  and  should  be  assigned  to  give  the  user  full  functionality  within 
dBASE  IV. 


SYS:DBNETCTL.300 


SYS:DBASE/SQLHOME 


SYS:DBASE/DBDAEA 


READ 

WRITE 

OPEN 

SEARCH 

READ 

OPEN 

SEARCH 

CREATE 

•WRITE 

•DELETE 

•PARENTAL 

READ 

WRITE 

OPEN 

SEARCH 

PARENTAL 

DELETE 

CREATE 

READ 

OPEN 

SEARCH 

CREATE 

•WRITE 

•DELETE 
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Ungermann- 
Bass  Network 
Information 


This  appendix  contains  information  for  users  who  are  about  to  install  multi¬ 
user  dBASE  IV  on  an  Ungermann-Bass  Net/One  PC  System.  Read  through 
each  section  before  following  the  installation  instructions  in  Chapter  2. 


Before  You  Begin 

The  instructions  below  assume  that  your  file  server’s  hard  disk  drive  is  iden¬ 
tified  as  drive  C.  If  you  use  a  different  drive  designation,  substitute  that  letter 
in  the  instructions. 

If  you  are  an  experienced  user  of  Ungermann-Bass  networks,  turn  to  the 
“Ungermann-Bass  Network  Quick-Install  Guide”  at  the  end  of  this  appendix. 


Network  Requirements 

Read  your  Net/One  PC  System  Manager’s  Guide  for  specific  requirements  and 
instructions  on  setting  up  workstations  and  file  server  microcomputers. 
Installing  dBASE  IV  on  a  Net/One  PC  System  requires  that  you  use  the 
Net/One  PC  System  (version  15.2)  and  install  one  Network  Adapter  Card  in 
each  file  server  and  workstation. 

The  network  file  server  and  workstations  must  each  have  a  minimum  of 
640K  RAM. 


Checking  Config^ys  on  the  File  Server 

The  file  server  must  have  a  text  file  called  Config.sys.  This  file  must  be  in  the 
root  directory  of  the  drive  from  which  the  file  server  is  started  when  the 
computer  is  turned  on.  If  the  file  server  boots  from  drive  C,  for  example, 
Config.sys  must  be  in  the  root  directory  of  drive  C. 

Config.sys  contains  instructions  to  configure  DOS  on  your  computer  (see 
your  DOS  manual).  To  take  maximum  advantage  of  dBASE  IV*s  multiple  file 
handling  capabilities,  you  may  need  to  modify  this  file. 

To  edit  the  Config.sys  file,  use  the  DOS  EDLIN  utility  or  any  word  processor 
that  does  not  store  special  characters  (in  general,  control  characters  and/or 
printing  instructions)  in  the  file. 
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Check  the  contents  of  the  file,  making  sure  it  contains  the  following  settings: 

FILES  -  80 
BUFFERS  -  15 
LASTDRIVE  -  x 


where  x  is  a  valid  drive  letter  between  A  and  Z;  the  default  is  E.  Enter  a  let¬ 
ter  corresponding  to  the  highest-lettered  logical  drive  you  plan  to  use.  (A 
logical  drive  associates  a  drive  letter  not  already  assigned  to  a  physical  disk 
with  a  directory  location  on  the  network.) 


NOTE 

lb  allow  each  workstation  user  to  open  as  many  files  as  possible  with 
dBASE  IV,  use  the  following  formula  to  determine  the  Files  setting: 


(Number  of  workstations  x  20)  +  20  —  Files  setting 


Other  application  programs  may  require  more  files  to  be  open.  Adjust 
your  Files  setting  accordingly.  The  maximum  Files  setting  is  99  per 
workstation. 


Checking  Config.sys  on  Each  Workstation 

Each  workstation  must  also  have  a  Config.sys  file.  This  file  must  be  in  the 
root  directory  of  the  drive  from  which  the  workstation  is  started  when  the 
computer  is  turned  on. 

For  optimum  operation  of  multi-user  dBASE  IV  at  the  workstation,  check  the 
contents  of  the  Config.sys  file,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 
LASTDRIVE  -  x 

where  x  is  a  valid  drive  letter  between  A  and  Z;  the  default  is  E.  Enter  the 
letter  that  corresponds  to  the  highest-lettered  logical  drive  you  plan  to  use. 


Installing  Multi-User  dBASE  IV 

Follow  the  instructions  in  Chapter  2  to  install  multi-user  dBASE  IV  on  your 
file  server.  Then  follow  the  instructions  in  the  next  section  to  make 
dBASE  IV  shareable  on  the  network. 

If  you  have  any  previous  version  of  dBASE  on  your  hard  disk,  you  have  two 
choices: 

■  To  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  lb  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 
that  contains  the  previous  version.  The  previous  version  will  be  automat¬ 
ically  deleted.  (Your  data  files,  however,  will  be  left  intact.) 
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If  your  installation  attempt  fails,  the  following  documentation  may  provide 
additional  information: 

■  The  “Hardware  and  Software  Requirements”  section  in  your  Getting 
Started  booklet 

■  The  DOS  manual  discussion  of  subdirectory  and  file  limitations;  for 
example,  limitations  on  the  number  of  files  in  a  subdirectory  and  the 
number  of  files  in  the  root  directory 

■  Your  network  documentation,  for  corrective  action  if  a  network  error 
message  occurs 


Making  dBASE  IV  Shareable  on  the  Network 

Before  you  can  start  dBASE  IV,  you  need  to  make  the  DBASE  directory  and 
the  DBNETL.TL.300  directory  (which  maintains  a  count  of  the  maximum 
number  of  dBASE  users)  shareable  on  the  network.  This  section  describes 
how  to  do  the  following: 

■  Assign  a  network  name  to  the  DBASE  directory,  provide  a  network  path 
to  locate  the  directory  on  the  network,  and  set  read,  write,  and  create 
access  privileges.  You’ll  also  assign  a  network  name  and  read  and  write 
privileges  to  the  DBNETCTL.300  directory. 

■  Assign  logical  drive  letters  to  the  network  path  locating  the  DBASE  and 
DBNETCTL.300  directories. 

Follow  these  steps: 

1.  From  the  file  server,  enter  the  following  NET  SHARE  command: 

C>  NET  SHARE  DBASE-  C:\DBASE  /RWC  — 

The  DBASE  directory,  with  the  privileges  /RWC,  has  now  been  given  the 
network  name  DBASE. 

2.  Then  type: 

C>  NET  SHARE  DBUSERS -  C:\DBNETCTL.300  /RWC 

The  DBNETCTL.300  directory  has  now  been  given  the  network  name 
DBUSERS. 

3.  On  the  workstation  from  which  you  want  to  start  multi-user  dBASE  IV, 
enter  the  following  NET  USE  command: 

A>  NET  USE  D:  \\servername\DBASE  ♦♦ 

In  this  example,  the  NET  USE  command  associates  drive  letter  D  with 
the  network  name  DBASE.  Drive  D  is  also  referred  to  as  a  logical  drive. 
If  your  system  already  has  a  drive  D,  substitute  a  drive  letter  that  isn’t 
already  in  use.  For  the  servername  parameter,  substitute  the  network 
name  of  the  file  server. 
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4.  On  the  same  workstation,  enter  this  command: 

A>  NET  USE  E:  \\servername\DBUSERS*-* 

Now,  the  network  name  DBUSERS  is  associated  with  logical  drive  E. 

To  avoid  retyping  these  commands,  add  the  commands  in  steps  1  and  2  to 
the  file  server’s  Autoexec.bat  file,  and  add  the  commands  in  steps  3  and  4  to 
the  Autoexec.bat  file  for  each  workstation.  See  your  DOS  manual  for  instruc¬ 
tions  on  setting  up  batch  files.  Check  your  network  program  manual  for 
requirements  for  the  file  server’s  Autoexec.bat  file. 

Starting  Multi-User  dBASE  IV 

You  use  the  DBASE  command  to  start  up  multi-user  dBASE  IV  from  a  work¬ 
station.  You  can  also  start  multi-user  dBASE  IV  from  a  non-dedicated  file 
server;  however,  workstation  users  may  notice  that  the  network  runs  slower. 

Before  starting  multi-user  dBASE  IV,  your  DOS  path  must  be  set  to  the  two 
logical  drives  you  assigned  earlier  (this  example  continues  to  use  drives  D 
and  E). 

1.  Type: 

C>  PATH-  D:\;E:\  — 

2.  Then  type: 

DBASE  — 

Please  note: 

■  If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been 
PROTECIhd.  dBASE  IV  users  should  refer  to  “Using  the  Network”  in 
Advanced  Tbpics ,  for  instructions  on  logging  into  a  PROTECTed  sys¬ 
tem.  Users  of  dBASE  IV  Developer’s  Edition  should  refer  to  “Using 
the  Network”  in  Networking  with  dBASE  IV. 

■  If  an  error  message  appears,  dBASE  IV  users  should  see  Appendix  A 

of  Advanced  Tbpics ,  for  an  explanation  of  the  message  and 
recommended  corrective  action^  Users  of  dBASE  IV  Developer’s  y ' 

Edition  should  see  Appendix  A  of  Networking  with  dBASE  IV. 


Starting  an  Application  Program 

You  can  start  an  application  program  at  the  same  time  you  start  up  multi¬ 
user  dBASE  IV.  Follow  these  steps: 

1.  Enter  the  path  statement: 

C>  PATH—  D:\;E:\  -*-* 
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2.  Follow  the  DBASE  command  with  the  name  of  your  application 
program : 

C>  DBASE  [d:\path]  <  filename  >  *♦ 

For  [d:\path],  substitute  the  drive  and  directory  location  of  the  applica¬ 
tion  program . 

For  <  filename  >  ,  substitute  the  name  of  the  application  program  you 
want  to  run. 

For  example,  this  command  runs  the  application  program  Myprog  (on  drive) 
when  you  start  up  multi-user  dBASE  IV:  ' 

C>  DBASE  G:D/MYPROG  *♦ 


Creating  a  Batch  File  for  Starting 

You  can  simplify  the  process  of  starting  dBASE  IV  by  storing  the  PATH  and 
DBASE  commands  in  a  batch  file.  Type  the  following  commands  from  the 
DOS  prompt  to  create  a  batch  file  named  Dlan.bat  that  contains  the  informa¬ 
tion  you  enter  at  the  keyboard.  When  you’re  finished,  the  Dlan.bat  file  will 
be  stored  in  the  current  drive  and  directory. 

C>  COPY  CON:  DLAN.BAT  — 

PATH  -  D:\;E\~ 

DBASE  [[d:\path]  <  filename >  ] 

Ctrt-Z  — 

Please  note: 

■  The  first  line  creates  a  file  called  Dlan.bat. 

■  In  the  second  line,  D:\  and  E:\  represent  the  logical  drive  letters 
assigned  to  the  DBASE  and  DBNETCTL.300  directories. 

■  The  third  line  is  the  DBASE  command  you  use  to  start  multi-user 
dBASE  IV,  complete  with  an  optional  program  filename  and  path. 

■  The  fourth  line,  Ctri-Z  followed  by  closes  and  saves  the  batch  file. 

You  should  store  the  file  in  the  directory  from  which  you  normally  start 
dBASE  IV.  Then,  instead  of  typing  the  PATH  and  DBASE  commands,  simply 
type  DLAN  «-»  to  start  multi-user  dBASE  IV. 

If  the  dDASE  IV  log-in  t creep  ippears,  your  system  has  bcurfRQTECTcTf^ 

dBASE  IV  users  should  refer  to  "Using  the  Network”  in  Advanced  Ibpics ,  for 
suggestions  on  what  to  do  after  starting  multi-user  dBASE  IV.  Users  of 
dBASE  IV  Developer’s  Edition  should  refer  to  “Using  the  Network”  in 
Networking  with  dBASE  IV. 


NETWORK  INSTALLATION 
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Ungermann-Bass  Network  Quick-Install  Guide 


After  you  have  installed  dBASE  IV,  follow  these  steps  to  properly  configure 
the  network  for  use  with  dBASE  IV: 

1.  Check  the  contents  of  the  Config.sys  file  at  the  file  server  and  at  each 
workstation,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 

The  file  server  must  also  contain  a  LASTDRIVE-  x  statement,  where  x  is 
the  highest-lettered  logical  drive  you  plan  to  use. 

2.  Enter  the  following  commands  in  the  Autoexec.bat  file  at  the  file  server: 

C>  NET  SHARE  DBASE- C:\DBASE  /RWC  — 

C>  NET  SHARE  DBUSERS-  C:\DBNETCTL.300  /RWC  — 

3.  Enter  the  following  commands  in  the  Autoexec.bat  file  at  each/worksta- 

tion:  ^ — 

A>  NET  USE  D:  \\servernama\DBASE 

A>  NET  USE  E:  \\servername\DBUSERS  — 
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3COM  3  + 

Network 

Information 


This  appendix  contains  information  for  users  who  are  about  to  install  multi¬ 
user  dBASE  IV  on  a  3Com  3+  network.  Read  through  each  section  before 
following  the  installation  instructions  in  Chapter  2. 


Before  You  Begin 

The  procedures  and  instructions  in  this  section  assume  the  following: 

■  You’ve  already  installed  your  3Com  3+  network  and  the  3+  Share  Soft¬ 
ware  network  program.  Refer  to  your  3+  Share  Administrator’s  Guide 
for  specific  instructions  on  setting  up  your  network. 

■  You’ve  set  up  your  network  with  the  file  server  operating  in  non¬ 
concurrent  or  dedicated  mode,  so  that  the  network  administrator  per¬ 
forms  all  operations  from  a  workstation. 

■  You’re  familiar  with  the  3+  Share  3F  program  SHARE  and  LINK 
commands. 

■  You’ve  made  3+  Share  startup  disks  for  each  of  your  workstations  or  set 
up  each  workstation  to  start  from  its  local  hard  disk. 

■  You’ve  already  created  a  shared  directory  on  the  Hie  server  called 
C:\APPS  that  users  are  linked  to  by  drive  D.  If  your  network  setup  uses 
different  drive  designations,  substitute  those  letters  in  the  instructions. 

■  The  special  sharename  APPSADMN  has  read/write/create  privileges  for 
the  \APPS  directory. 

■  The  programs  3F.exe  and  Login.exe  are  available  in  the  \APPS  directory. 

If  you  are  an  experienced  user  of  3Com  3  +  networks,  turn  to  the 

“3Com  3+  Network  Quick-Install  Guide’’  at  the  end  of  this  appendix. 
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Network  Requirements 

Read  your  3Com  3 +  Share  Administrator’s  Guide  and  3+  Share  User’s 
Guide  for  specific  requirements  and  instructions  on  setting  up  workstations 
and  file  server.  Installing  dBASE  IV  on  a  3Com  3+  network  requires  that 
you  use  the  3Com  3+  Share  Software  (Version  1.2)  and  install  a  3Com 
Etherlink  or  Etherlink  Plus  card  in  each  file  server  and  workstation.  File 
servers  and  workstations  on  the  network  must  have  a  minimum  of  640K 
RAM. 

Checking  Corrfig.sys  on  Each  Workstation 

Each  workstation  must  have  a  text  file  called  Config.sys.  This  file  must  be 
in  the  root  directory  of  the  drive  from  which  the  workstation  is  started 
when  the  computer  is  turned  on.  If  the  workstation  starts  from  drive  C,  for 
example,  Config.sys  must  be  in  the  root  directory  of  drive  C. 

Config.sys  contains  instructions  to  configure  DOS  on  each  computer.  (Refer 
to  your  DOS  manual  for  further  information.)  To  take  maximum  advantage 
of  dBASE  IVs  multiple  file  handling  capabilities,  you  may  need  to  modify 
this  file. 

To  edit  the  Config.sys  file,  use  the  DOS  EDLIN  utility  or  any  word  processor 
that  does  not  store  special  characters  (in  general,  control  characters  and/or 
printing  instructions)  in  the  file.  Check  the  contents  of  the  file,  making  sure 
it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 
LASTDRIVE-  x 

where  x  is  a  valid  drive  letter  between  A  and  Z.  Enter  a  letter  corresponding 
to  the  highest-lettered  logical  drive  you  plan  to  use.  logical  drive  associ¬ 
ates  a  drive  letter  not  already  assigned  to  a  physical  disk  with  a  directory 
location  on  the  network.) 


Installing  Multi-User  dBASE  IV 

Follow  the  instructions  in  Chapter  2  to  install  multi-user  dBASE  IV  on  your 
file  server.  When  the  INSTALL  program  prompts  for  the  directory  to  install 
dBASE  IV,  specify  the  \APPS\DBASE  directory.  After  the  installation  is 
complete,  follow  the  instructions  in  the  next  section  to  make  dBASE  IV 
shareable  on  the  network. 

If  you  have  any  previous  version  of  dBASE  on  your  hard  disk,  you  have  two 
choices: 

■  To  save  the  previous  version,  uninstall  it.  Be  sure  to  use  the  disks  from 
that  previous  version  to  uninstall. 

■  To  delete  the  previous  version,  install  dBASE  IV  into  the  same  directory 
that  contains  the  previous  version.  The  previous  version  will  be  automat¬ 
ically  deleted.  (Your  data  files,  however,  will  be  left  intact.) 
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If  your  installation  attempt  fails,  the  following  documentation  may  provide 
additional  information: 

■  The  ‘‘Hardware  and  Software  Requirements"  section  in  your  Getting 


S  tar  ted  (Rookie?) 


m  The  DOS  manual  discussion  of  subdirectory  and  file  limitations;  for 
example,  limitations  on  the  number  of  files  in  a  subdirectory  and  the 
number  of  files  in  the  root  directory 

■  Your  network  documentation,  for  corrective  action  if  a  network  error 
message  occurs 

A  directory  named  DBNETCTL.300  is  also  created  during  multiuser 
dBASE  IV  installation.  This  directory  is  used  to  keep  track  of  the  number  of 
workstations  that  can  run  dBASE  IV  on  the  network  at  any  given  time.  Leave 
the  privileges  for  this  directory  as  read/write,  to  allow  the  Access  Control 
Program  to  update  files.  Do  not  delete  this  directory  or  change  any  of  its 
contents. 


k  WARNING 

A  file  named  Login. db  is  created  in  the  dBASE  IV  directory  the  first 
time  a  user  starts  up  dBASE  IV  on  a  network.  This  file  is  used  with 
the  DISPLAY  USERS  command  to  list  users  currently  running 
dBASE  IV.  If  you  run  multi-user  dBASE  IV  before  you  set  file 
attributes  to  program  files,  do  nor  make  file  privileges  for  the 
Login. db  file  read-only.  The  file  must  be  left  with  read/write  privi¬ 
leges  to  allow  users  to  start  dBASE  IV. 


Sharing  Directories 


These  instructions  assist  you  in  sharing  the  subdirectory  of  \APPS  for  multi¬ 
user  dBASE  IV  files. 

1.  Log  in  as  the  server-user  at  a  workstation  and  link  to  the  \APPS  directory 
using  the  sharename  DBADMN,  with  all  privileges.  Type: 

A>  3F  LOGIN  [server];  LINK  D:  APPS  — 

For  [server],  substitute  the  name  of  the  server  on  which  you  want  to 
install  dBASE  IV. 

2.  Run  the  3F  utility  by  typing: 

A>  D:<~ 

D>  3F  — 
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3.  To  create  the  shared  subdirectory  of  \APPS  for  application  files,  type  the 
following  commands. 

3F>  SHARE  ?  — 

Sharename?  DBASE  ♦» 

Path?  C:\APPS\DBASE  ♦* 

Password?  [password  1] 

For  [password  1],  substitute  the  password  that  each  user  will  have  to 
enter  to  use  the  directory.  If  you  don’t  want  to  have  password  protection 
in  effect,  just  press  ♦*.  The  following  prompt  appears: 

Access  (/RWC)? 

Press  ♦♦  again.  The  following  message  appears: 

\\Serrer:Domain:Org\DBASE  shared 

DBASE  is  created  as  a  subdirectory  of  the  \APPS  directory  on  drive  C. 
You’ll  install  multi-user  dBASE  IV  and  other  dBASE  IV  program  files 
into  this  directory. 

4.  At  this  point,  create  any  other  shared  or  private  directories  that  you  want 
on  your  file  server.  You  could  use  the  3F  SHARE  command  to  create  a 
root  database  file  directory,  for  example,  C:\DBFILES,  or  create  a  data¬ 
base  file  subdirectory  of  C:\APPS\DBASE: 

3F>  SHARE  ?  — 

Sharename?  DBF1LES  «-* 

Path?  C:\DBF1LES  — 

Password?  [password2]  <*■* 

Again,  for  [password2],  you  have  the  option  of  creating  a  password  for 
the  directory.  If  you  don’t  want  to  have  password  protection  in  effect, 
just  press  The  following  prompt  appears: 

Access  (/RWC)? 

Press  •*-»  again.  The  following  message  appears: 

\\Senrer:DomaiJi:Org\DB FILES  shared 

Later,  individual  workstation  users  can  create  subdirectories  to  hold 
application  programs  or  data  files.  For  example,  a  user  may  want  to  cre¬ 
ate  a  directory  for  accounting  programs  and  data  files  called 
\DBFILES\ACCTNG. 


G-4 


APPENDIX  G:  3COM  3+  NETWORK  INFORMATION 


PACE:  5  SESS:  5  Thu  flay  19  09:46:37  1988 
k2/«l  l  J  obz/CLS_manhat /GRP_/n«nh«t/ JOB_piannet  i  n*  t/DI  V_n  i  appg 

5.  Next,  use  the  LINK  command  to  associate  the  DBASE  and  DB FILES 
directories  (and  any  other  subdirectories  you’ve  created)  with  network 
logical  drive  letters.  Type: 

3F>  LINK  F:  DB  FILES  (/PASS  -  password2] 

3F>  LINK  G:  DBASE  [/PASS  -  passwordl] 

In  both  of  these  commands,  if  you  entered  a  password  in  step  3,  type 
/PASS-  followed  by  the  password. 

Network  drive  F  is  linked  to  the  C:\DBFILES  directory,  and  drive  G  is 
linked  to  the  C:\APPS\DBASE  directory. 

6.  Now  exit  the  3F  utility  command,  and  make  drive  A  the  default  drive  by 
pressing  followed  by  A: 


Starting  Multi-User  dBASE  IV 

To  run  multi-user  dBASE  IV  you  must  first  set  up  logical  drive  assignments 
(using  the  LINK  command)  for  your  workstation’s  home  directory,  and  for 
the  dBASE  LV~directory.  You  must  also  specify  a  DOS  PATH  for  any  logical 
drives  you’d  like  to  search  when  executing  programs.  Then,  to  start 
dBASE  IV,  you  type  the  DBASE  command. 

Follow  these  steps: 

1.  To  create  logical  drive  assignments,  for  example,  linking  drive  D  to  the 
APPS  directory  and  drive  E  to  the  user’s  home  directory  on  the  network, 
type  the  following: 

A>  3F  LOGIN  [user  name);  LINK  D:  \\[servername]\APPS; 

LINK  E: 

For  [user  name],  enter  a  log-in  name  which  has  been  created  by  the  net¬ 
work  administrator.  For  [servername],  substitute  the  name  given  to  the 
file  server. 

2.  To  create  logical  drive  assignments,  for  example,  linking  drive  F  to  the 
C:\DBFILES  directory,  and  drive  G  to  the  \APPS\DBASE  directory,  type 
the  following  commands: 

A>  3F  LINK  F:  \\[server]\DBFILES  [/PASS-  password2]  — 

A>  3F  LINK  G:  \\[server]\DBASE  [/PASS  -  passwordl]  ** 

Again,  substitute  your  server  name  in  the  commands  above.  For  the 
bracketed  password  items,  type  /PASS-  followed  by  the  password  name 
if  you  assigned  one  when  you  created  each  directory. 

3.  To  help  organize  data  files  and  dBASE  application  programs,  you  may 
want  to  create  subdirectories  within  the  DBFILES  directory  to  store  files 
for  particular  applications  or  for  certain  individuals.  For  example,  to  cre¬ 
ate  a  subdirectory  for  accounting  application  data  and  program  files,  you 
could  create  the  directory  C:  DB  FILES \ACCTNG  by  doing  the  following: 

A>  F:<~ 

F>  MD  ACCTNG  — 
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4.  To  work  from  the  \DB  FILES \ACCTNG  directory  as  the  current  directory, 
type: 

F>  CD  ACCTNG  — 

5.  To  create  a  DOS  PATH,  type: 

F>  PATH  -  G:\~~ 

6.  Then,  to  start  multi-user  dBASE  IV,  type: 

F >  DBASE  #DF-  G:  — 

Following  #DF-  ,  you  specify  the  logical  drive  on  which  multi-user 
dBASE  IV  is  located. 


Once  you’ve  typed  the  DBASE  command,  the  dBASE  IV  copyright  notice 
should  appear.  It  includes  the  information  you  entered  on  the  Software7Reg- 
istration  screen. 


~L 


Please  note: 


■  If  the  dBASE  IV  log-in  screen  appears,  your  system  has  been 

PROTECTed.  dBASE  IV  users  should  refer  to  “Using  the  Network”  in 
Advanced  Topics ,  for  instructions  on  logging  into  a  PROTECTed  system. 
Users  of  dBASE  IV  Developer’s  Edition  should  refer  to  “Using  the 
Network”  in  Setworking  with  dBASE  IV. 

m  If  an  error  message  appears  and  dBASE  IV  does  not  start,  first  check  to 
make  sure  you’ve  entered  the  DBASE  command  correctly,  and  then 
check  to  see  that  you’ve  correctly  specified  the  LINK  commands  and 
DOS  PATH. 


dBASE  IV  users  should  see  Appendix  A  of  Advanced  Topics ,  for  a  listing  of 
dBASE  IV  error  messages,  and  take  the  corrective  action  that  is  suggested. 
Users  of  dBASE  IV  Developer’s  Edition  should  see  Appendix  A  of  Networking 
with  dBASE  TV.  If  a  network  error  message  appears,  check  your  network 
manual  for  possible  corrective  actions  you  can  take. 


Starting  an  Application  Program 

You  can  start  an  application  program  at  the  same  time  you  start  dBASE  IV. 
Type  the  following  commands: 

F>  PATH  -  F:\;G:\  — 

F>  DBASE  [d:\path]  <  filename >  ♦♦ 

For  [d:\path],  substitute  the  drive  and  directory  location  of  the  application 
program. 

For  <  filename  >  ,  substitute  the  name  of  the  application  program  you  want 
to  run. 
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For  example,  if  an  application  program  called  Myprog  is  located  in  the 
C:\DBFILES\ACCTNGsubdirectory,  you  could  start  the  application  program 
automatically  by  typing  the  following  command: 

F>  DBASE  F:\ACCTNGi\MYPROG  ~ 

In  this  example,  the  exact  location  of  the  Myprog  application  is  specified; 
however,  because  the  Myprog  application  is  located  in  a  directory  specified 
along  the  DOS  PATH,  you  could  omit  it. 


Creating  a  Batch  File  for  Starting 

You  can  simplify  the  process  of  starting  dBASE  IV  by  storing  the  commands 
needed  to  start  up  dBASE  IV  in  a  batch  file.  The  following  procedure  creates 
a  batch  file  named  Dlan.bat.  When  you  run  the  Dlan.bat  file  from  a  worksta¬ 
tion,  multi-user  dBASE  IV  will  start  automatically.  If  you  specify  a  program 
filename,  it  will  be  automatically  executed,  unless  you’ve  set  up  log-in  pass¬ 
word  protection  to  dBASE  IV. 


Use  the  DOS  EDLIN  utility  (or  any  word  processor  that  does  not  store  spe¬ 
cial  characters  in  the  file)  to  create  the  Dlan.bat  file.  Enter  the  following 
statements,  pressing  *♦  at  the  end  of  each  line.  Enter  /NP  at  the  end  of  the 
third  and  fourth  lines,  if  you  want  to  avoid  displaying  prompts  that  ask  you 
to  confirm  the  destruction  of  existing  links. 

ECHO  OFF 

D: 

3F  LINK  G:  \\[ server] \DBASE  [/PASS- passwordl]  [/NP] 

3F  LINK  F:  \\[server]\DB FILES  [/PASS  -  password2]  [/NP] 

PATH  -  F:\;G:\; 

F; 

CD  \ACCTNG 

DBASE  [d:\path]  <  filename  >  ] 


The  Dlan.bat  batch  file  assumes  that  the  user  is  already  logged  in  at  the 
workstation,  and  has  linked  drive  D  to  the  \APPS  directory  and  drive  E  to 
the  workstation’s  home  directory.  To  run  the  Dlan.bat  file,  after  logging  in  at 
the  workstation,  type  DLAN 


NOTE 

You  can  specify  LINK  and  PATH  commands  in  a  workstation’s 
Autoexec.bat  file  so  they  are  set  up  automatically  when  the  worksta¬ 
tion  is  started  up.  Check  the  existing  Autoexec.bat  Hies  to  make  sure 
the  LINKs  you  set  up  in  the  batch  file  do  not  conflict  with  existing 
ones.  _ users  r 

^  *3  •  * 

{z^i*** for  suggestions  on  what  to  do  after  starting  multi-user  dBASE  IV.^  AAvo." 


U,ser$  B  F*5  ^  J-k. 

DritWrs  r^r 

"Us]y 

A 
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3Com  3  +  Network  Quick-Install  Guide 

After  you  have  installed  dBASE  IV,  follow  these  steps  to  properly  configure 
the  network  for  use  with  dBASE  IV: 

1.  Check  the  contents  of  the  Config.sys  file  at  the  file  server  and  at  each 
workstation,  making  sure  it  contains  the  following  settings: 

FILES  -  99 
BUFFERS  -  15 

The  file  server  must  also  contain  a  LASTDRIVE-  x  statement,  where  x  is 
the  highest-lettered  logical  drive  you  plan  to  use. 

2.  Log  in  as  the  server-user  at  a  workstation  and  link  to  the  \APPS  directory 
using  the  sharename  DBADMN,  with  all  privileges.  Type: 

A>  3F  LOGIN  (server);  LINK  0:  APPS 

For  [server],  substitute  the  name  of  the  server  on  which  you  want  to 
install  dBASE  IV. 

3.  Run  the  3F  utility  by  typing: 

A>  D:<~ 

D>  3F  ♦* 

4.  To  create  the  shared  subdirectory  of  \APPS  for  application  files,  type  the 
following  commands. 

3F>  SHARE  ?  ~ 

Sharename?  DBASE  ♦* 

Path?  C:\APPS\DBASE  *■* 

Password?  [passwordl]  ♦♦ 

For  [passwordl],  substitute  the  password  that  each  user  will  have  to 
enter  to  use  the  directory.  If  you  don’t  want  to  have  password  protection 
in  effect,  just  press  <•-».  The  following  prompt  appears: 

Access  (/RWq? 

Press  ♦♦  again.  The  folio*  ing  message  appears: 
\\Server:Doaaia:C>rg\DBASE  shared 

DBASE  is  created  as  a  subdirectory  of  the  \APPS  directory  on  drive  C. 
You’ll  install  multi-user  dBASE  IV  and  other  dBASE  IV  program  files 
into  this  directory. 


G-8 


APPENDIX  G:  3COM  3+  NETWORK  INFORMATION 


jOBNAflE:  PAGE:  9  SESS:  5  Thu  May  19  09:46  :  37  1  988 

•tata/d I  Bh2/a i  I  j  otoz/CLS.jnanhat /GRPjnanhat / JOB .jnannat  l  n« t /DI V_n  I  appg 

5.  At  this  point,  create  any  other  shared  or  private  directories  that  you  want 
on  your  file  server.  You  could  use  the  3F  SHARE  command  to  create  a 
root  database  file  directory,  for  example,  C:\DBFILES,  or  create  a  data¬ 
base  file  subdirectory  of  C:\APPS\DBASE: 

3F>  SHARE  ?  — 

Sharename?  DBFILES  —•> 

Path?  C:\DBFILES  — 

Password?  [password2]  — 

Again,  for  [password2],  you  have  the  option  of  creating  a  password  for 
the  directory.  If  you  don’t  want  to  have  password  protection  in  effect, 
just  press  The  following  prompt  appears: 

Access  (/RWC)? 

Press  again.  The  following  message  appears: 
\\Serrer:DoiBaiii:Org\DBASE  shared 

Later,  individual  workstation  users  can  create  subdirectories  to  hold 
application  programs  or  data  files.  For  example,  a  user  may  want  to  cre¬ 
ate  a  directory  for  accounting  programs  and  data  files  called 
\DBFILES\ACCTNG. 

6.  Next,  use  the  LINK  command  to  associate  the  DBASE  and  DBFILES 
directories  (and  any  other  subdirectories  you’ve  created)  with  network 
logical  drive  letters.  Type: 

3F>  LINK  F:  DBFILES  [/PASS -  password2]  ♦♦ 

3F>  LINK  G:  DBASE  [/PASS  -  password'll  — 

In  both  of  these  commands,  if  you  entered  a  password  in  step  4,  type 
/PASS-  followed  by  the  password. 

Network  drive  F  is  linked  to  the  C:\DBFILES  directory,  and  drive  G  is 
linked  to  the  C:\APPS\DBASE  directory. 

7.  Now  exit  the  3F  utility  command,  and  make  drive  A  the  default  drive  by 
pressing  followed  by  A:  <•*. 

8.  lb  create  logical  drive  assignments,  for  example,  linking  drive  D  to  the 
APPS  directory  and  drive  E  to  the  user’s  home  directory  on  the  network, 
type  the  following: 

A>  3F  LOGIN  [user  name];  LINK  D:  \\[servername]\APPS; 

LINK  E:  ♦* 

For  [user  name],  enter  a  log-in  name  which  has  been  created  by  the  net¬ 
work  administrator.  For  [servername],  substitute  the  name  given  to  the 
fije  server. 
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9.  To  create  logical  drive  assignments,  for  example,  linking  drive  F  to  the 
C:\DBFILES  directory,  and  drive  G  to  the  \APPS\DBASE  directory,  type 
the  following  commands: 

A>  3F  LINK  F:  \\[server]\DBFILES  [/PASS  -  password2]  — 

A>  3F  LINK  G:  \\[server]\DBASE  [/PASS  -  passwordl]  — 

Again,  substitute  your  server  name  in  the  commands  above.  For  the 
bracketed  password  items,  type  /PASS-  followed  by  the  password  name 
if  you  assigned  one  when  you  created  each  directory. 

10.  To  help  organize  data  files  and  dBASE  application  programs,  you  may 
want  to  create  subdirectories  within  the  DBFILES  directory  to  store  files 
for  particular  applications  or  for  certain  individuals.  For  example,  to  cre¬ 
ate  a  subdirectory  for  accounting  application  data  and  program  files,  you 
could  create  the  directory  C;DB FILES \ACCTNG  by  doing  the  following: 

A>  Ft  — 

F>  MD  ACCTNG  — 

11.  To  work  from  the  \DB  FILES \ACCTNG  directory  as  the  current  directory, 
type: 

F>  CD  ACCTNG  — 

12.  To  create  a  DOS  PATH,  type: 

F >  PATH-  G:\  — 

13.  Then,  to  start  multi-user  dBASE  IV,  type: 

F>  DBASE  #DF-  G:  — 

Following  #DF-  ,  you  specify  the  logical  drive  on  which  multi-user 
dBASE  IV  is  located. 

Once  you’ve  typed  the  DBASE  command,  the  dBASE  IV  copyright  notice 
should  appear.  It  includes  the  information  you  entered  on  the  Software 
Registration  screen. 
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Change 

Summary 


Introduction 

dBASE  IV  is  the  next  generation  in  the  dBASE  family  of  products.  It  has  an 
extensive  set  of  new  features,  com  m  ands,  functions,  and  capabilities. 

dBASE  IV  is  a  completely  new  data  management  system  based  on 
dBASE  III  PLUS  but  with  the  addition  of  a  completely  new  user  interface, 
full  query-by-example  and  SQL  capability,  a  fully  featured  applications  gener¬ 
ator,  and  hundreds  of  improvements  on  the  dBASE  command  language.  The 
dBASE  IV  Developer’s  Edition  is  a  completely  revised  applications  develop¬ 
ment  and  distribution  system  created  for  the  development  community  featur¬ 
ing  a  complete  applications  template  language  and  vastly  improved  RunTime 
capability. 

Table  1  shows  the  major  components  of  the  new  products  and  indicates 
where  to  look  for  in-depth  information  on  each. 

Table  i-1  dBASE  IV  data  management  system 


Component 

Control  Center 

dBASE  Language  Enhancements 

SQL 

QBE 

RunTime 

Applications  Generator 
Advanced  Applications  Generator 
Networking 


Manual 

Using  the  Menu  System 
Language  Reference 
Using  dBASE  IV  SOL 
Using  the  Menu  System 

RunTime ,  Language  Reference  COMPILE 
and  DBLINK  commands 

Using  the  dBASE  IV  Applications  Generator 
1b m plate  Language 
networking  with  dBASE  IV 


CHANGE  SUMMARY 


JOBNAHE:  PAGE:  2  SESS:  9  Mon  Apr  A  13:58:44  1988 

Otate/d  t  sk2/a  l  I  j  obz/CLS_manhat/GRP_manhat/JOB_manchgsum/OI  V_cs  i  ntro 

Some  components  of  Table  i-1  are  completely  new  to  dBASE  IV.  These  are: 

■  The  Control  Center  —  the  heart  of  the  new  user  interface 

■  SQL  —  Structured  Query  Language,  an  implementation  of  IBM’s  SQL 
data  access  language 

■  QBE  —  Query-by-Example,  a  new  and  easy-to-use  method  of  accessing 
data  stored  in  the  dBASE  IV  system 

■  Applications  Generator  —  an  easy-to-use  method  of  creating  programs 
for  dBASE  IV 

■  Advanced  Applications  Generator  —  a  complete  template  language  for 
customizing  the  Applications  Generator,  reports,  forms,  and  labels 

Each  of  these  components  represent  major  advances  in  the  ease  of  use  and 
functionality  of  dBASE  IV  over  dBASE  III  PLUS.  We  urge  you  to  explore 
these  exciting  new  additions  to  dBASE  IV  by  looking  at  the  manuals  for 
each. 

This  Change  Summary  describes  dBASE  IV’s  enhancements  and  additions  to 
the  commands  and  functions  of  dBASE  III  PLUS.  The  Change  Summary 
assumes  that  you  are  already  familiar  with,  and  perhaps  programming  in, 
dBASE  III  PLUS.  Therefore,  it  does  not  explain  commands  and  programming 
examples  in  detail,  but  rather  focuses  on  the  differences  between  dBASE  IV 
and  dBASE  III  PLUS.  Please  refer  to  the  other  documentation  accompanying 
dBASE  IV  for  more  detailed  information  on  the  product  and  how  to  use  it. 
For  experienced  users,  this  Change  Summary  will  help  you  start  using  the 
nearly  unlimited  wealth  of  power  and  features  now  available  to  you  with 
dBASE  IV. 
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From 

dBASE  III  PLUS 
to  dBASE  IV 


Overview  of  the  Changes 

dBASE  IV  has  many  new  features  that  enhance  its  power  for  both  end-users 
and  applications  developers.  This  section  highlights  many  of  the  basic  differ¬ 
ences  between  the  general  working  environment  of  dBASE  IV  and 
dBASE  III  PLUS. 


New  User  Interface 

A  completely  new  interface  allows  you  to  harness  dBASE  IV’s  features  and 
power  without  needing  to  write  statements  at  the  dot  prompt. 

Every  full-screen  component  of  dBASE  IV,  from  EDIT  to  SET,  now  supports 
a  menu  bar  of  pull-down  menus.  These  new  menus  are  supplemented  by 
dBASE  IV’s  new  keyboard  macro  feature. 

The  screen  designers  for  forms,  labels,  and  reports  share  a  common  “what 
you  see  is  what  you  get”  (WYSIWYG)  approach  to  designing.  You  can  easily 
keep  track  of  which  forms,  reports,  and  labels  work  with  which  database 
files. 

Browse  and  Edit  are  more  closely  related,  with  a  special  function  key  that 
lets  you  flip  between  these  two  methods  of  displaying  data. 

The  dBASE  III  PLUS  approach  to  handling  views  and  queries  has  been 
enhanced  to  offer  a  direct  and  powerful  way  to  join,  filter,  and  project  data 
from  multiple  files. 

The  Assistant  has  been  replaced  by  the  far  more  sophisticated  Control  Cen¬ 
ter,  which  makes  it  easier  to  work  with  all  the  essential  database 
components. 

The  Control  Center 

The  Control  Center  is  a  new  interface  for  dBASE,  offering  you  a  single  sys¬ 
tem  for  handling  the  elements  of  dBASE  IV.  You  can  use  the  Control  Center 
to  open  and  close  files,  and  access  the  menu  system  to  establish  views,  reach 
design  screens,  run  programs,  and  manage  files  and  catalogs. 
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The  Control  Center  displays  all  the  database  files,  views,  forms,  reports, 
labels,  and  programs  in  the  current  catalog.  After  selecting  an  object  (such 
as  a  format  file),  you  can  then  quickly  display  either  the  object’s  data  or  its 
design. 

This  “point  and  shoot”  Control  Center  is  the  perfect  complement  to  the 
command-oriented  dot  prompt. 

The  Control  Center  also  has  some  features  not  available  from  the  dot 
prompt,  such  as  a  tree-structured  DOS  file  directory  and  manager.  Please 
refer  to  the  Using  the  Menu  System  manual  for  complete  information  on 
dBASE  IV’s  Control  Center  and  menu  system. 


Browse  and  Edit 

In  dBASE  IV,  the  Browse  and  Edit  screens  have  been  linked  together  to 
form  two  sides  of  the  same  coin.  You  use  the  F2  Data  key  to  toggle  between 
table  and  form  displays  of  data. 

The  menu  bar  for  Browse  has  been  greatly  expanded,  and  a  menu  bar  has 
been  added  to  the  Edit  screen.  Memo  fields  have  a  more  powerful  editor  and 
can  now  be  searched.  The  cursor  movements  on  the  Browse  and  Edit 
screens  are  more  logical  and  helpful. 


Error  Handling 

Error  handling  from  the  dot  prompt  has  been  improved.  When  an  error 
occurs,  you  may  now  select  options  to  edit  the  erroneous  command  line,  get 
help,  or  cancel  the  command. 


Forms 


The  screen  painter  has' been  greatly  improved.  You  can  lay  down  all  the 
fields  and  field  names  at  once  with  an  automatic  layout.  You  can  assign  col¬ 
ors.  to  design  elements  or  draw  crisp  lines  and  boxes. 

You  will  find  it  easier  to  move  objects  around  the  screen,  and  you  can  copy 
text,  fields,  and  boxes  to  other  places  on  a  form.  Calculated  fields  are  avail¬ 
able  and  you  have  more  picture  functions  and  template  characters  to  choose 
from. 

Memo  fields  can  be  defined  to  appear  already  opened  into  their  window 
form,  and  you  can  specify  that  certain  fields  can  be  edited  only  after  a  given 
condition  is  satisfied. 
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Help  System 


The  Help  system  is  far  more  powerful  than  before.  Context  sensitive  Help 
boxes  provide  how-to  information  for  using  the  menu  system  and  the  Appli¬ 
cations  Generator.  They  also  offer  syntax  and  examples  for  all  the  commands 
and  functions  in  dBASE  IV  and  SQL.  These  Help  boxes  each  contain  the  fol¬ 
lowing  selections  for  increased  functionality: 


■  CONTENTS 

■  RELATED  TOPICS 

■  BACKUP 

■  PRINT 


A  nested  Table  of  Contents  for  on-line  Help 
A  pop-up  list  of  related  Help  screens 

Allows  you  to  move  around  the  Help  system  with¬ 
out  losing  the  original  context 

Prints  the  Help  screen  for  future  reference 


Labels 


The  labels  generator  has  been  improved  over  dBASE  III  PLUS.  You  no 
longer  have  to  enter  dBASE  expressions  for  each  line  of  the  label.  Instead, 
labels  use  the  layout  surface  common  to  dBASE  IV.  You  simply  place  fields 
where  you  want  them. 

Fields  can  be  added  from  the  underlying  database  file  or  view.  You  can  also 
use  new  calculated  fields  and  special  fields  such  as  the  current  date  or  time. 

The  labels  generator  offers  full  support  of  text  styling  and  print  settings, 
including  automatic  setup  for  the  nine  most  common  label  sizes. 


Macros 


dBASE  IV  has  its  own  complete  keyboard  macro  capability.  You  are  able  to 
create  and  save  a  series  of  keystrokes  for  playback  at  any  time. 

Queries  and  Views 

dBASE  IV  offers  a  new  work  surface  for  creating  the  queries  that  define 
views.  You  can  more  easily  join  files,  filter  their  records,  and  choose  which 
fields  to  display.  You  can  also  create  calculated  fields  and  global  filters  for 
any  query. 

Special  update  queries  help  you  automatically  change  many  records  at  once. 

Reports 

Reports  have  been  completely  redesigned.  The  report  generator  is  now  a 
WYSIWYG  layout  surface.  You  design  a  report  around  a  bands  concept, 
where  each  band  is  either  a  specific  grouping  of  records,  or  a  special  band 
such  as  a  report  introduction  or  summary. 
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Reports  can  include  calculated  fields  and  special  fields  such  as  the  system 
date  or  a  running  page  number.  You  have  a  choice  of  five  types  of  summary 
fields  (such  as  Total  or  Average)  and  two  editing  modes:  word  wrap  oTTlay- 
out.  * - 


Three  different  automatic  report  layouts  make  it  easy  to  generate  reports 
quickly.  Flexible  box  and  line  drawing  are  available,  along  with  numerous 
printing  options.  A  full  menu  of  text  styling  options  lets  you  add  bold  or  ital¬ 
ics,  as  well  as  different  type  fonts  and  pitches.  You  can  also  choose  whether 
to  send  your  report  to  a  printer  or  an  electronic  file. 

Structured  Query  Language  (SQL)  Capability 

dBASE  IV  supports  both  interactive  and  embedded  structured  query 
language  (SQL)  capability.  Please  refer  to  the  Using  dBASE  IV SQL  manual 
for  complete  information. 


Database  Files 

Changes  to  many  aspects  of  database  files  make  dBASE  IV  more  powerful 
and  efficient  than  dBASE  III  PLUS. 


Increased  Structure  Limits 

Database  stuctures  may  now  contain  up  to  255  fields  per  record.  In  addition, 
each  field  may  now  optionally  be  designated  as  a  key  field  on  which  the  data¬ 
base  is  indexed.  dBASE  IV  automatically  creates  a  new  .mdx  (multiple  index) 
file  if  any  field  in  the  database  is  designated  as  a  key  field.  Please  see  the  sec¬ 
tion  in  this  booklet  on  indexing  for  full  information  on  the  new  .mdx  files. 

dBASE  IV  database  structures  may  also  contain  a  new  numeric  data  type,  F, 
that  indicates  fields  that  contain  floating  point  numbers.  See  the  section 
below  on  fixed  and  floating  point  numbers  for  more  information. 

Multiple  Child  Relations 

A  major  improvement  in  dBASE  IV  is  the  added  support  of  multiple-child, 
multiple-file  relationships.  In  dBASE  IV,  a  single  file  can  now  be  related  to 
more  than  one  file  simultaneously. 


PROTECT 

The  PROTECT  utility  is  now  immediately  available  from  the  dot  prompt  and 
Control  Center,  and  is  no  longer  an  external  utility.  In  addition,  memo  fields 
may  now  be  encrypted,  either  explicitly  through  the  PROTECT  command  or 
automatically  when  the  related  database  is  encrypted. 

All  features  of  the  PROTECT  utility  are  now  also  available  in  the  single-user 
as  well  as  multi-user  mode. 
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Read-Only  Files 

dBASE  IV  now  honors  the  DOS  read-only  file  attribute  when  operating  in 
either  the  single- or  multi-user  mode. 


Commands  and  Functions 


dBASE  IV  has  a  wealth  of  new  com  m  ands  and  functions  to  m  ake  it  far  more 
efficient  and  powerful  than  previous  versions  of  dBASE. 


ALIAS  Support 


dBASE  IV  allows  many  commands  and  functions  to  operate  on  unselected 
work  areas.  For  example,  RECNO(Custom er)  returns  the  current  record 
number  in  the  work  area  with  the  alias  Customer,  or  you  can  open  a  data¬ 
base  in  an  unselected  work  area  with  USE  Customer  IN  2. 

The  enhanced  functions  are: 


BOFQ 

LUPDATEQ 

DBF() 

MDX() 

DELETEDQ 

NDX() 

EOF() 

ORDERQ 

FIELDQ 

RECCOUNT() 

FLOCK() 

RECNOQ 

FOUND() 

RECSIZE() 

ISMARKEDQ 

RLOCKQ 

KEY() 

TAG() 

LOCKQ 

enhanced  commands  are: 

DISPLAY  STRUCTURE 

SKIP 

GO/ GOTO 

UNLOCK 

LIST  STRUCTURE 

USE 

CALCULATE  Command 

To  meet  the  need  for  a  single  command  capable  of  processing  a  number  of 
database  records  for  a  variety  of  statistical  and  financial  functions  in  a  single 
pass,  the  CALCULATE  command  has  been  added  to  dBASE  IV.  CALCULATE 
can  process  and  evaluate  any  of  its  functions  in  a  single  pass  through  the 
database.  For  example,  the  following  are  equivalent  in  dBASE  III  PLUS  and 
dBASE  IV: 

dBASE  III  PLUS: 


USE  customer 

COLNT  TO  Mxjlists 

SW  TotaLDol  TO  Amt_Sperrt 
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dBASE  IV: 

USE  customer 

CALCULATE  CNTO  SLMCTotaLItoO  TO  fferjlsts, 

AmtLifeent 

The  CALCULATE  command,  however,  will  complete  its  processing  much 
faster  than  the  two  separate  COUNT  and  SUM  commands  since  CALCULATE 
requires  only  one  pass  through  the  database.  The  COUNT  and  SUMj> 
Ccommands  each  require  a  separate  complete  pass  tnrougn  the  records.  See 
Language  Reference  for  full  information  on  the  new  CALCULATE  command. 


Character  Expressions  v.  Macro  Expansions 

dBASE  IV  allows  character  expressions  to  be  used  as  filenames  in  addition 
to  literal  file0iames  and  macro  expansions.  Acharacter  expression  is  dramat¬ 
ically  faster  than  an  equivalent  macro  expansion.  However,  dBASE  must  be 
able  to  recognize  the  difference  between  character  expressions  and  literals. 
For  example: 

STORE  "Payrolir  to  Mfilenane 
USE  8Mf  Rename 

works  as  it  did  in  dBASE  III  PLUS,  but  is  much  slower  than: 

STORE  "Payroll"  to  Mfilename 
USE  Mfilenane^r 

in  dBASE  IV.  Note  that  a  simple 
USE  Mfilename 

will  attempt  to  open  a  database  called  Mfilename  rather  than  one  called  Pay¬ 
roll.  You  can  force  dBASE  to  evaluate  a  character  expression  by  enclosing 
the  expression  in  parenthese^,  such  as: 

STORE  "Payroll"  toMfilenane 
USE  (Mfilename)  INDEX  (Mfilename) 

Character  expressions  can  also  be  used  in  many  other  places  in  dBASE  IV, 
such  as  in  PICTURE  expressions. 


Increased  Command  Line  Length 

dBASE  IV  supports  command  lines  up  to  1,024  characters  long  in  program 
files  and  from  the  dot  prompt. 


1-6 


FROM  dBASE  III  PLUS  TO  dBASE  IV 


JOBNAHE:  PAGE:  7  SESS:  5  Hon  Apr  4  13:55:55  1988 

Stat«/di  sk2/«l  I  j  ob*/CLSjn»nhat/GRP_rnanhat/JOB_fnanchgsum/DIV_cschapl 

Date  Delimiters 

dBASE  IV  uses  curly  braces  ({})  to  identify  date  values.  For  example: 
STORE  {11/20/1958}  to  ndate 


is  equivalent  to: 

STORE  CTCD0 11/20/1958')  to  mfete 


Financial  Functions 


A  number  of  financial  functions  have  been  added  to  dBASE  IV  for  ease  in 
calculating  future  values,  present  values,  payments,  and  other  financial  data. 

The  financial  functions  are: 


FV() 

PAYMENT() 

PV() 

In  addition,  the  new  CALCULATE  command  is  able  to  compute  net  present 
value  (NPV). 


LOOKUP()  Function 

dBASE  IV’s  LOOKUP()  function  will  save  programmers  significant  time  and 
programming  effort.  LOOKUP()  can  search  an  unselected  database  for  a 
desired  expression  and  return  data  from  that  database  (or  any  other  open 
database)  with  one  statement.  For  example,  consider  a  common  task  in  applica 
tions:  Given  a  customer  number,  what  is  the  customer’s  full  name?  Assuming 
a  database  containing  the  customer’s  number  and  first  and  last  name  fields 
indexed  on  the  customer’s  number,  in  dBASE  III  PLUS  you  would  need  the 
following  statements: 

USE  Customer  INDEX  CLStrtar 
SEBC  MCusUbr 
IF  FCLNDO 

STORE  TRIM(First_N3ne)-*/*  "4Last_Name  TO  MCtst-Name 
ELSE 

STORE  "  (LHc-runT  TO  MCusUfame 
BDIF 


With  the  LOOKUP()  function,  you  need  only: 


MCLst_Nwe  =  umPCfTOM(0^cmer->FirstLName)-F  -  -tOstomer-X^sUbme/  MCustLTbr, 
Custcmer->CLSt_rt>r) 
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Mathematical  Functions 

A  number  of  new  mathematical  and  trigonometric  functions  have  been 
added  to  dBASE  IV  for  use  in  complex  calculations. 

The  new  mathematical  and  trigonometric  functions  are: 


SIN() 

RTOD() 

ASIN() 

DTOR() 

COS() 

SIGNQ 

ACOS() 

CEILING() 

TAN() 

FLOOR() 

ATAN() 

LOGIOQ 

ATN2() 

RAND( ) 

PI() 

Memo  Reid  Commands  and  Functions 


Memo  field  processing  is  greatly  improved  in  dBASE  IV  with  the  addition  of 
new  commands  and  functions  to  easily  enter,  edit,  process,  and  output 
memo  fields.  Memo  fields  are  far  more  functional  in  dBASE  IV  than  in 
dBASE  III  PLUS  as  you  may  now  access  their  contents  in  searches  through  a 
database  or  under  program  control. 

Disk  space  usage  with  regard  to  memo  fields  has  been  vastly  improved  over 
previous  versions  of  dBASE.  Instead  of  wasting  space  occupied  by  outdated 
memo  field  information,  dBASE  IV  recycles  this  old  space,  resulting  in  sig¬ 
nificantly  smaller  .dbt  files.  Memo  fields  are  now  limited  to  64K  bytes  each. 

The  new  or  enhanced  memo  field  commands  and  functions  are: 


APPEND  MEMO 
COPY  MEMO 
SET  BLOCKSIZE  TO 


AT() 

LEN() 

SUBSTR() 

REPLACE 


UPDATE 

MEMLINES() 

MLINEQ 

STUFFQ 

LEFT() 

RIGHTO 

SET  WINDOW  OF  MEMO  TO 


SCAN/ENDSCAN  Command 

dBASE  IV  provides  a  new  SCAN/ENDSCAN  programming  construct  that 
establishes  a  loop  to  find  and  process  database  records  meeting  a  specific 
condition.  SCAN/ENDSCAN  loops  are  easier  to  program  and  require  fewer 
statements  than  equivalent  DO  WHILE/ENDDO  loops.  Statements  within  a 
SCAN  loop  may  be  skipped  with  a  LOOP  command,  and  a  SCAN  loop  may  be 
terminated  with  an  FYTT  rnmmanH  _ 

yvi<wiz"  T o 

Mcrxr 

SCAN  FOR  DueJJate  =  DATEO  ./W>.  AmtJXje  >0  \ 

DO  Letter  WITH  LastName,  FirstName,  AmtJX* 

BDSCAN 


[For  example,  the  following  commands  have  the  same  practical  effect: 
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is  equivalent  to: 


LOCATE  FOR  DueJtote  =  DATEO  .AM).  AttUJlp  >  0 
DO  VWLE  FOLNDO  .AM).  .NOT.  BDFO 

DO  Letter  WITH  LastName,  FirstName,  AmtJXje 
CCNTIME 
BDOO 


Statistical  Functions 

Full  statistical  capability  has  been  added  to  dBASE  IV  with  the  ability  to  eas¬ 
ily  calculate  standard  deviations,  variances,  minimums,  maximums,  averages, 
sums,  and  counts  of  database  records  in  one  pass  through  the  CALCULATE 
com  mand. 

Please  see  the  section  on  the  CALCULATE  command  above  for  more 
information. 


Memory  Variables  and  Arrays 

dBASE  IV  has  expanded  support  of  memory  variables  and  a  full  implementa¬ 
tion  of  arrays  in  memory. 

Arrays 

dBASE  IV  fully  supports  arrays  of  memory  variables  with  the  following  array 
commands  and  functions:  APPEND  FROM  ARRAY,  AVERAGE,  COPY  TO 
ARRAY,  DECLARE,  and  SUM.  dBASE  IVs  arrays  can  have  up  to  two  dimen¬ 
sions.  The  maximum  number  of  array  elements  is  limited  only  by  the 
amount  of  memory  available. 

I 

Increased  Memory  Variable  Limits 

The  maximum  number  of  memory  variables  has  been  increased  to  2,048.  In 
addition,  dBASE  IV  has  an  improved  memory  variable  search  algorithm  to 
speed  up  search  and  retrieval  of  memory  variables. 

Numeric  memory  variables  in  dBASE  IV  support  both  the  N  and  new  F  data 
types.  Numeric  constants  always  have  a  data  type  of  N.  Memory  variables 
created  from  a  numeric  constant  also  have  a  data  type  of  N.  (Please  see  the 
section  on  fixed/floating  point  numbers  for  more  information  on  the  new  F 
data  type.) 

Memory  variables  created  from  a  database  field  will  have  the  same  data  type 
as  the  field.  The  data  type  of  memory  variables  created  as  the  result  of  a 
command  or  function  depends  on  the  output  of  the  command  or  function. 

If  an  expression  uses  both  fixed  and  floating  point  numbers,  dBASE  IV  will 
ordinarily  return  a  floating  point  number.  The  exceptions  are  when  a  float¬ 
ing  point  number  is  converted  to  a  fixed  point  number  with  the  FIXED() 
function  (or  vice  versa),  or  when  a  REPLACE  command  is  issued,  since  the 
data  is  written  to  the  disk  in  ASCII  notation. 


CHANGE  SUMMARY 
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Data  Integrity 

dBASE  IV  has  new  commands  and  features  to  help  ensure  the  integrity  of 
your  data. 


AUTOSAVE  Feature 

Anew  SET  command  provides  automatic  and  immediate  updating  of  disk  15 
files  and  file  allocation  tables  upon  a  change.  SET  AUTOSAVE  on/OFF,  ifset^ 
ON,  enables  the  automatic  updating  of  disk  information.  This  feature  ensures 
that  all  changes  to  databases  and  other  files  are  written  to  disk  immediately 
to  prevent  loss  of  data  in  the  event  of  a  power  failure  or  other  mishap. 


Transaction  Processing 

dBASE  IV  now  supports  full  transaction  processing  with  rollback  capability, 
using  the  new  BEGIN  TRANSACTION,  END  TRANSACTION,  and  ROLLBACK 
commands.  Once  a  transaction  is  started  with  BEGIN  TRANSACTION,  each 
change  to  data  files  and  index  files  is  recorded  in  a  special  transaction  file. 
When  the  END  TRANSACTION  statement  is  executed,  the  transaction  is  con¬ 
sidered  to  have  terminated  successfully  and  the  transaction  file  is  closed  and 
deleted.  If,  however,  an  error  should  occur  during  the  transaction,  any  data 
and  index  files  involved  may  be  automatically  restored  with  the  ROLLBACK 
command  to  the  condition  they  were  in  before  the  transaction  was  initiated. 

The  USE  command  has  been  enhanced  to  verify  the  consistency  of  a  data¬ 
base  and/or  index  file  before  opening  the  file.  If  a  transaction  has  terminated 
unsuccessfully,  the  database  header  is  automatically  flagged.  When  a  USE  is 
attempted  on  the  possibly  inconsistent  database,  a  warning  message  displays 
suggesting  a  ROLLBACK. 

If  a  CANCEL  command  is  executed  during  an  active  transaction,  a^ROLL- 
BACK  is  automatically  executed.  If  a  SUSPEND  is  issued  during  a  transac¬ 
tion,  the  transaction  remains  active  and  all  commands  issued  while  in  sus¬ 
pended  mode  become  part  of  the  transaction.  However,  if  you  request  a 
ROLLBACK  while  in  suspended  mode,  you  will  not  be  able  to  RESUME  the 
suspended  program  because  "ou  would  start  in  the  middle  of  a  transaction. 
After  a  ROLLBACK,  RESUME  executes  exactly  like  CANCEL. 

BEGIN  TRANSACTION  and  END  TRANSACTION  must  both  be  contained  in 
the  same  command  or  procedure  file  to  be  effective. 


Power  and  Compatibility 

Enhancements  to  dBASE  IV  make  it  the  most  powerful  and  compatible  data 
management  system  available  on  the  market  today. 
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Automatic  Multi-User  File  and  Record  Locks 

dBASE  IV  now  provides  automatic  file  and  record  locking  for  the  APPEND, 
BROWSE,  CHANGE,  EDIT,  READ,  and  REPLACE  commands.  The  automatic 
file  and  record  locking  features  allow  multiple  users  to  simultaneously 
access  and  update  different  parts  of  the  same  database  file  without  requiring 
explicit  file  and  record  locks.  This  means  that  applications  may  now  be  used 
in  single-  and  multi-user  environments  with  a  minimum  of  modification. 
dBASE  IV’s  record  locking  function  has  also  been  enhanced  to  allow  multi¬ 
ple,  shared  record  locks  from  a  single  RLOCK()  or  LOCK()  statement,  and  to 
identify  the  holder  of  a  record  lock. 

A  new  m ulti-user  com m and,  SET  REPROCESS  TO  <  expN  >  ,  allows  you 
to  specify  the  number  of  times  a  multi-user  command  is  automatically 
attempted  before  dBASE  IV  returns  an  error.  When  a  locking  error  occurs, 
dBASE  IV  now  allows  you  to  retry  the  lock  attempt. 


Automatic  Refresh  of  Changed  Data 

When  using  BROWSE  or  EDIT,  dBASE  IV  allows  you  to  SET  REFRESH  TO 
<  expN  >  to  specify  the  number  of  seconds  to  wait  between  automatic 
checks  of  the  database  file  in  USE  to  see  if  another  user  has  altered  the  data 
stored  there.  Most  importantly,  if  another  user  has  changed  the  data, 
dBASE  IV  will  automatically  display  the  changed  data  on  your  screen. 


Expanded  and  Extended  Memory  Support 

dBASE  IV  will  automatically  take  advantage  of  memory  above  the  640K  limit 
conforming  to  the  LIM  4.0  specifications. 


Fixed  and  Floating  Point  Numbers 

All  numeric  fields  and  memory  variables  with  data  type  N  are  now  consid¬ 
ered  to  be  fixed  point  numbers  instead  of  floating  point  numbers,  allowing 
for  greater  precision  and  predictability  in  numeric  comparisons.  Fields  and 
variables  of  type  N  have  greater  precision  than  in  dBASE  III  PLUS,  but 
retain  full  compatibility. 

Anew  numeric  data  type,  F,  indicates  numbers  to  be  considered  as  floating 
point  numbers.  Both  F  and  N  data  types  may  now  be  specified  in  the  struc¬ 
ture  of  a  database.  Floating  point  numbers  have  greater  precision  than  fixed 
point  type  N  numbers.  Type  F  fields  and  numbers,  however,  are  not  down¬ 
wardly  compatible  with  dBASE  III  PLUS. 

Both  type  F  and  type  N  numbers  are  technically  floating  point  numbers.  The 
difference  between  the  data  types  is  in  the  way  dBASE  IV  stores  the  numbers 
internally. 


CHANGE  SUMMARY 
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Indexing 


dBASE  IV  uses  a  new  method  of  indexing -that  is  able  to  maintain  up  to  47 
index  tags  in  a  single  file  called  an  .mdx  (multiple  index)  file.  Each  index  tag 
is  similar  to  an  old  .ndx  file,  and  consists  of  a  tag  name  and  key  expression. 
The  basic  difference  is  that  up  to  47  different  index  expressions  (the  equiva¬ 
lent  of  47  old  .ndx  files)  can  be  maintained  in  a  single  mdx  file.  When  a 
database  structure  is  created  or  modified,  you  have  the  option  of  specifying 
any  (or  all,  up  to  47)  fields  as  an  index  field.  If  any  field  is  so  designated,  a 
production  .mdx  file  is  created  with  the  same  name  as  the  database  file.  After 
index  tags  are  added  to  the  .mdx  file,  each  index  tag  in  the  production  mdx 
file  is  automatically  updated  each  time  data  is  changed  in  the  database  file. 

In  addition,  you  may  have  more  than  one  mdx  file  active  at  once,  which 
allows  you  to  have  literally  hundreds  of  indexes  open  at  the  same  time. 

The  greatest  benefits  of  .mdx  files  are  that  up  to  47  index  expressions  are 
contained  in  a  single  file  without  the  need  for  additional  files  to  be  open, 
and  that  each  index  tag  is  automatically  updated  upon  a  change  in  the  data¬ 
base.  The  new  .mdx  files  also  support  descending  indexes. 

For  example,  in  dBASE  III  PLUS,  you  might  have  needed  the  following 
indexes  on  a  customer  database: 

USE  Customer 

INDEX  CN  Custitr  TO  Ostnbr 

IMXEX  CN  SLBSTRCLast^ame/l/ffl+SLBSTPCFirstjname^l,!)  TO  Custname 
INDEX  CN  ZiftjxxfetSLBSTRCLa^jiame/l,®  TO  Custzip 

The  databases  and  indexes  require  four  open  files  and  you  need  to  remem¬ 
ber  to  have  each  index  explicitly  opened  whenever  data  in  the  file  could  pos¬ 
sibly  be  updated. 

Using  an  .mdx  file  in  dBASE  IV,  you  would  need  the  following  similar 
com  mands: 

USE  Customer 

INDEX  (H  Cust_rbr  TAG  Custnbr 

INDEX  CN  SUBSTRCLast_oame,1 ,85+SLBSTR(FirstLrame,1 ,1)  TAG  Custname 
IM>EX  CN  Ziq_code+5LBS7R<Lastj  ere/I,®  TAG  Ostzip 

The  result  is  that  an-. mdx  file  called  Customer. mdx  is  created  and  each  index 
expression  is  contained  in  the  .mdx  file  as  a  tag.  However,  only  two  files  are 
required  to  be  open,  and  each  tag  is  automatically  updated  whenever  data  in 
Customer. dbf  is  changed. 

dBASE  IV  also  maintains  complete  compatibility  with  dBASE  III  PLUS  .ndx 
files.  dBASE  IV  also  allows  up  to  10  .ndx  files  to  be  open  simultaneously  per 
database  file. 
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MODIFY  COMMAND/Memo  Field  Editor 

dBASE  IV’s  built-in  program  file  and  memo  field  editor  has  been  greatly 
enhanced  and  is  now  capable  of  editing  large  files  up  to  1,024  characters  by 
32,000  lines.  The  new  editor  has  complete  text  editing  capabilities,  including 
block  copy  and  move  functions  as  well  as  an  automatic  indenting  feature  for 
program  files.  In  addition,  the  editor  may  be  used  either  with  a  pull-down 
menu  interface  or  familiar  dBASE  III  PLUS/WordStar*  control  code 
sequences. 


Working  with  Other  Re  Formats 

dBASE  IV  now  has  the  ability  to  directly  read  and  write  files  created  with 
other  products,  including  dBASE  II*.  Framework  II™,  RapidFile™, 
MultiPlan®,  LOTUS*  1-2-3*  (both  .wks  and  .wkl  file  formats),  and  PFS*. 
dBASE  IV  also  supports  plain  ASCII  files  and  products  using  the  DIF  spread¬ 
sheet  format.  The  commands  supporting  foreign  files  are: 

APPEND  FROM 
COPY  TO 
EXPORT  TO 
IMPORT  FROM 


Programming  Tools 

A  number  of  new  programming  tools  make  programming  with  dBASE  IV 
easier  and  more  efficient  than  ever.  This  section  describes  some  of  the  new 
tools  available  to  you. 


Applications  Generator 

The  dBASE  III  PLUS  Applications  Generator  has  been  replaced  with  a  com¬ 
pletely  new  and  powerful  development  tool  that  can  be  used  by  both  new 
and  advanced  programmers  to  create  fully  functional  applications  without 
writing  a  single  line  of  code. 

Unlike  the  dBASE  III  PLUS  Applications  Generator,  the  new  Applications 
Generator  allows  you  to  easily  modify  menus  and  assign  actions  to  them,  so 
you  can  create  applications  just  the  way  you  or  your  clients  want  them.  The 
easy-to-use  menu  system  also  shortens  your  development  time. 

The  Applications  Generator  can  be  invoked  from  both  the  Control  Center 
and  the  dot  prompt.  Please  refer  to  the  Using  the  dBASE  IV Application y&en- 
erator  manual  for  complete  information  on  the  new  Applications  Generator. 


Compiler 


dBASE  IV  includes  an  automatic  built-in  program  compiler  that  greatly 
increases  execution  speed  by  interpreting  and'parsing  command,  procedure, 
and  format  files  into  intermediate  executable  code,  and  saving  the  intermedi¬ 
ate  code  in  program  object  (.dbo)  files. 
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For  developers,  dBASE  IV  affords  even  greater  execution  speed  when 
program  object  (.dbo)  files  are  linked  into  one  large  object  file.  Please 
see  the  COMPILE  and  DBLINK  commands  in  the  next  section  for  further 
inform  ation. 


Data  Validation 

The  @  <  row  >  ,  <  col>  SAY.. .GET  command  has  been  greatly  enhanced  to 
provide  extended  data  validation  with  the  VALID  <  condition  >  option. 
VALID  is  followed  by  a  condition  which  must  be  satisfied  before  the  data  is 
accepted  into  the  GET  variable.  The  <  condition  >  may  be  any  expression 
which  returns  a  logical  true  (.T.)  or  logical  false  (.F.). 

The  <  condition  >  may  also  be  a  user-defined  function  that  returns  a  logical 
value  or  changes  the  value  of  the  GET  upon  returning.  Using  a  user-defined 
function  as  the  condition  allows  unlimited  data  validation  by  theTprogram- 
mer. 


Debugger 

A  full  featured  program  debugger  has  been  added  to  dBASE  IV.  It  works  in  a 
window  environment  and  with  a  new  editor.  The  debugger  is  invoked  with 
either  DEBUG  <  filename  >  or  SET  TRAP  ON. 

The  dBASE  IV  debugger  provides  windows  for  debugger  status,  editing, 
breakpoints,  and  display.  The  Debug  window  shows  environmental  informa¬ 
tion  such  as  the  program  file  and  procedure  name  being  executed,  current 
line  number,  work  area,  database,  and  index  file  in  use,  and  current  record 
number.  The  Edit  window  displays  the  program  source  file  being  executed 
and  allows  changes  made  during  debugging  to  be  stored  in  the  file. 

The  Breakpoint  window  accepts  up  to  10  conditions  to  be  evaluated  after 
each  line  of  code  is  executed.  If  any  of  the  conditions  evaluates  to  a  logical 
true  (.T.),  program  execution  is  halted  and  the  Debug  window  becomes 
active.  The  Display  window  accepts  one  or  more  expressions  and  displays  the 
results  based  on  the  current  environment  status. 


Menus 


dBASE  IV  now  supports  user-definable  menus  in  the  programming  language. 
The  menu  commands  and  functions  enable  you  to  easily  create  and  modify 
pop-up  and  horizontal  bar  menus  similar  to  dBASE  IV*s  own  user  interface. 
(A  pop-up  menu  appears  in  a  window  on  the  screen  and  disappears  after  you 
make  a  selection;  horizontal  bar  menus  are  command  line  or  pull-down 
menus.) 
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The  new  user-definable  menu  commands  and  functions  are: 


DEFINE  POPUP 
DEFINE  BAR 
ACTIVATE  POPUP 
SHOW  POPUP 
DEACTIVATE  POPUP 
CLEAR  POPUPS 
RELEASE  POPUPS 
ON  SELECTION  POPUP 
POPUP() 

BAR() 

PROMPT() 


DEFINE  MENU 
DEFINE  PAD 
ACTIVATE  MENU 
SHOW  MENU 
DEACTIVATE  MENU 
RELEASE  MENU 
CLEAR  MENUS 
ON  PAD 

ON  SELECTION 
MENU() 

PA D() 


Procedures 

dBASE  IV  treats  procedures  differently  than  dBASE  III  PLUS.  dBASE  IV  sup¬ 
ports  the  concept  of  procedures  within  any  program  file.  When  a  program 
source  file  is  compiled  into  program  object  code  (a  .dbo  file),  any 
procedures  encountered  in  the  command  file  are  added  to  a  procedure  list 
for  that  object  file.  Procedures  in  the  procedure  list  are  then  available  to  any 
subsequently  called  command  file.  Thus,  all  program  files  are  now  effectively 
procedure  files. 

The  total  number  of  procedures  per  program/procedure  file  hasbeetO 
(^Increased  from  32  to  1,170.  Procedures  may  be  a  maximum  of  6TK~byfes  of 
generated  object  code. 

dBASE  JV  still  supports  the  SET  PROCEDURE  TO  command  for  procedures 
that  are  contained  in  a  file  not  activated  by  a  DO  <  filename  >  statement. 


Template  Language 

The  Template  Language  is  completely  new  in  dBASE  IV.  It  allows  the  devel¬ 
oper  to  customize  menu  applications  created  with  the  Applications  Genera¬ 
tor  or  the  forms,  labels,  and  reports  produced  by  the  new  screen  painter. 
The  Template  Language  also  provides  the  ability  to  automatically  document 
applications  created  with  these  new  tools. 

This  highly  sophisticated  but  easy-to-use  language  gives  developers  all  the 
necessary  resources  to  create  custom  applications  in  their  own  style. 


User-Defined  Functions 

dBASE  IV  now  supports  user-defined  functions  to  allow  unlimited  flexibility 
and  power  in  the  command  language.  If  you  need  a  function  that  is  not  pro¬ 
vided  in  dBASE  IV,  you  can  create  a  user-defined  function,  customized  and 
tailored  to  your  exact  needs.  A  user-defined  function  can  be  placed  in  any 
dBASE  expression  or  condition.  User-defined  functions  are  particularly  use¬ 
ful  when  used  in  conjunction  with  the  VALID  command  to  create  sophisti¬ 
cated  data  validation  routines. 
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Windowing 


dBASE  IV  fully  supports  windowing  from  within  the  command  programming 
language.  dBASE  supports  up  to  20  windows  at  once.  Windows  may  be  over¬ 
laid  and  moved,  and  support  full  color  selection,  programmable  locations, 
and  borders. 


The  new  dBASE  IV  commands  for  manipulating  windows  are: 


DEFINE  WINDOW 
ACTIVATE  SCREEN 
ACTIVATE  WINDOW 
DEACTIVATE  WINDOW 
CLEAR  WINDOW 


RELEASE  WINDOW 
SAVE  WINDOW 
RESTORE  WINDOW 
MOVE  WINDOW 
SET  WINDOW  OF  MEMO  TO 


System  Setup 

An  expanded  configuration  file  and  new  commands  make  system  configura¬ 
tion  easier  and  more  flexible  using  dBASE  IV. 


International  Currencies  and  Dates 

dBASE  IV  provides  a  number  of  functions  to  support  international  currency 

and  date  formats.  The  functions  are: 

■  SET  CURRENCY  TO  [<  expC>  ]  to  change  the  currency  character 

■  SET  CURRENCY  LEFT/right  to  specify  whether  the  currency  character 
will  appear  to  the  left  or  right  of  a  monetary  amount 

■  SET  POINT  TO  [  <  expC>  ]  to  change  the  numeric  decimal  point 
character 

■  SET  SEPARATOR  TO  [<  expC>  ]  to  change  the  numeric  separator 
character 

■  DMY(<  expD>  )  to  return  a  date  expression  in  the  form  DD  Mon  YY  (or 
DD  Mon  YYYY  if  SET  CENTURY  is  ON) 

■  MDY(<  expD>  )  to  retur  n  a  date  expression  in  the  form  Mon  DD,  YY 
(or  Mon  DD,  YYYY  if  SET  CENTURY  is  ON) 

■  SET  DATE  [TO]  AMERICAN/ansi/british/french/german/italian/japan 
/usa/mdy/dmy/ymd  to  specify  the  date  format  used  for  subsequent  date 
displays 

■  SET  HOURS  TO  12/24  to  specify  whether  a  12-  or  24-hour  clock  is 
displayed 

■  SET  MARK  TO  [  <  expC>  ]  to  specify  which  character  is  used  to  sepa¬ 
rate  the  month,  day,  and  year  in  a  date  expression 
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Number  of  Open  Files  Increased 

The  maximum  number  of  simultaneously  open  files  has  been  increased  from 
15  to  99  files.  To  use  the  additional  files,  both  the  Config.db  and  Config.sys 
files  must  contain  an  appropriate  FILES—  statement. 

Print  System  Memvars 


dBASE  IV  supports  a  number  of  special  memory  variables  called  system 
memvars.  These  system  memvars  contain  settings  for  printed  output  such  as 
left  margin  (_lmargin),  printer  pitch  or  characters  per  inch-? 

C(~ppitch  -  and  right  margin  (_rmargin).  System  memvars  are  pre-  - 

ceded  by  an  underscore  to  keep  them  distinct  from  other  memory  variables. 
They  are  described  fully  in  the  Language  Reference  manual. 


Printer  Drivers 

To  further  enhance  the  quality  of  printed  output,  dBASE  IV  now  supports  the 
use  of  optional  installable  printer  drivers  to  control  print  functions.  The 
printer  drivers  allow  you  to  specify  such  print  attributes  as  bold,  italic, 
underlined,  superscript,  subscript,  and  print  font.  In  addition,  dBASE  IV 
allows  you  to  change  many  of  the  internal  print  variables  such  as  page  num¬ 
ber,  line  spacing,  and  page  offsets.  dBASE  IV’s  printer  drivers  are  compatible 
with  Framework  II  and  RapidFile  printer  drivers. 

Output  through  the  use  of  the  report  generator,  ?,  and  ??  commands  may 
specify  printer  styles.  The  ?  and  ??  commands  support  a  STYLE  option  to 
specify  print  styles.  Anew  command,  ???,  has  been  added  to  dBASE  IV  to 
send  an  expression  (typically  a  printer  control  command  string)  to  the 
printer  without  modification  by  the  printer  driver. 

To  allow  applications  developers  further  control  over  the  quality  of  printed 
output,  the  dBASE  IV  Developer’s  Edition  includes  a  printer  driver  toolkit  to 
modify  and  customize  printer  drivers  in  the  RunTime  manual. 
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Summary  of 
Modified 
Commands 
and  Functions 

Commands 


?  and  ??  now  support  AT,  FUNCTION,  and  PICTURE  keywords  to  specify  the 
format  of  displayed  or  printed  output.  ?  and  ??  also  support  a  new  STYLE 
option  to  further  specify  the  style  of  printed  output. 

???  <  expression  >  outputs  <  expression  >  to  the  printer  without  modifica¬ 
tion  by  the  installable  printer  driver.  ???  may  be  used  to  send  printer  control 
strings  directly  to  the  printer. 

@  <  rowl  >  ,  <  coll  >  SAY — GET  command  has  been  greatly  enhanced  to 
provide  extended  data  validation,  help,  and  custom  prompts  using  the  new 
[[OPEN]  WINDOW  <  window  name>  ],  [VALID  <  condition  >  ],  [ERROR 

<  expC>  ],  [WHEN  <  condition  >  ],  [DEFAULT  <  exp>  ],  [MESSAGE 

<  expC>  j,  and  [COLOR  [  <  standard  >  ],  [  <  enhanced  >  ]]  clauses.  The 
RANGE  clause  has  been  improved  to  allow  other  options  to  be  specified  after 
specifying  a  RANGE.  In  addition,  RANGE  now  requires  only  a  lower  bound 
to  be  specified;  upper  bounds  for  RANGE  are  now  optional. 

@  <  row  1  >  ,  <  coll>  FILL  TO  <  row2>  ,  <  col2>  COLOR 

<  color  attribute  >  allows  you  to  rapidly  change  the  display  color  attributes 
of  a  rectangular  portion  of  the  screen. 

@  <  rowl>  ,  <  col  1  >  TO  <  row 2 >  ,  <  col2>  [DOUBLE/ PANEL/ NONE/ 

<  border  definition  string >  ]  COLOR  <  color  attribute  >  has  been 
enhanced  to  allow  you  to  select  the  characters  used  to  draw  boxes  on  the 
screen  and  specify  the  color  of  the  box. 

ACTIVATE  MENU  <  menu  name>  [PAD  <  pad  name>  ]  displays  a  previ¬ 
ously  DEFINEd  horizontal  bar  menu  and  transfers  control  to  that  menu. 

ACTIVATE  POPUP  <  popup  name>  displays  a  previously  DEFINEd  pop-up 
menu  and  transfers  control  to  it. 

ACTIVATE  SCREEN  directs  screen  output  from  a  previously  ACTIVATEd  win-  ,■ 

dow  to  the  global  screen  without  bringing  the  global  screen  to  the~'>  iaJ 

^foreground.  ~  - - ^  "" - 

ACTIVATE  WINDOW  <  window  name  list >  /ALL  displays  and  activates  the 
windows  contained  in  the  name  list  or  all  windows.  When  a  window  is  acti¬ 
vated,  all  screen  input  and  output  take  place  in  that  window. 

APPEND  FROM  <  filename >  /?/ ARRAY  <  array  name> 

[FOR  <  condition  >  ][[TYPE]  SDF/DIF/SYLK/WKS/FW2/RPD/dBASEII/ 

DELIMITED  [WITH  BLANK/  <  delimiter  ]]  has  been  enhanced  to  option¬ 
ally  append  records  to  a  database  from  a  named  array,  and  supports  new 
LOTUS  1-2-3,  Framework  II,  RapidFile,  and  dBASE  II  file  types. 
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APPEND  MEMO  <  memo  field  name>  FROM  <  filename  >  [OVERWRITE] 
appends  the  entire  contents  of  <  filename  >  to  the  memo  field  specified  in 
the  current  record.  If  the  OVERWRITE  option  is  specified,  the  memo  field  is 
erased  before  the  file  is  read  into  the  field. 

AVER/^3E  [<  expN  list  >  ]  [<  scope  >  ]  [FOR  <  condition  >  ]  [WHILE 

<  condition  >  ]  [TO  <  memvar  Iist>  /TO  ARRAY  <  array  name>  ]  replaces 
the  values  of  one  or  more  array  elements  in  the  named  array  with  the  com¬ 
puted  averages  of  the  specified  elements. 

BEGIN  TRANSACTION  [  <  path  name  >  ]  instructs  dBASE  IV  to  begin 
recording  subsequent  modifications  of  data  and  index  files  in  a  transaction 
log  file.  All  transactions  are  recorded  until  an  END  TRANSACTION 
command  is  encountered  in  the  normal  course  of  processing,  or  a^ROLL- 
BACK  command  is  issued  following  an  error  condition.  When  END  TRANS¬ 
ACTION  is  executed,  dBASE  IV  closes  and  deletes  the  active  transaction  log 
file,  releases  all  active  locks,  and  restores  the  integrity  flag  in  the  database 
file  header.  The  BEGIN  and  END  TRANSACTION  statements  must  be  con¬ 
tained  in  the  same  procedure  or  command  file  to  be  effective. 

BROWSE  has  been  much  improved  with  an  enhanced  menu  bar  and  the  abil¬ 
ity  to  edit  memo  fields.  It  can  operate  within  a  user-defined  window,  auto¬ 
matically  pan  fields,  and  display  calculated  fields. 

When  using  BROWSE  in  a  multi-user  environment,  dBASE  IV  now  performs 
a  record  lock  only  when  you  attempt  to  modify  information  contained  in  the 
record  without  first  attempting  a  manual  record  lock.  If  another  user 
changes  information  in  a  record  that  you  are  browsing,  dBASE  IV  will  auto¬ 
matically  display  the  changed  information  on  your  screen. 

BUILD  is  a  stand-alone  utility  with  enhanced  COMPILE,  DBLINK,  and  COPY 
capabilities.  Given  the  root  program  name  of  an  application,  BUILD  is  capa¬ 
ble  of  compiling,  linking,  and  copying  the  entire  application  to  distribution 
diskettes.  BUILD  is  included  with  the  dBASE  IV  Developer’s  Edition  and  is 
described  fully  in  the  RunTime  m anual. 

CALCULATE  [<  scope  >  ]  [FOR  <  condition  >  ]  [WHILE  <  condition  >  ] 
NPV(  )/  STD( )/  VAR( )/  MIN( )/  MAX( )/  AVG(  )/  SUM( )/  CNT(  )  [TO 

<  memvar  list >  /TO  ARRAY  <  array  name>  ]  processes  records  in  the 
active  database  for  the  financial  function  NPV()  (net  present  value).  It  also 
handles  the  statistical  functions  of  AVG()  (arithmetic  mean),  CNT()  (count 
records),  MAX()  (maximum),  MIN()  (minimum),  STD()  (standard  deviation), 
SUM()  (sum  of  values),  and  VAR()  (variance). 

CHANGE  has  been  improved  to  maintain  compatibility  with  the  enhanced 
EDIT  command.  The  new  CHANGE  options  are  described  in  the  Language 
Reference  manual. 

CLEAR  MENUS  erases  all  horizontal  bar  menus  from  the  screen  and  releases 
them  from  memory.  CLEAR  MENUS  also  clears  all  horizontal  bar  menu  ON 
SELECTION  and  ON  PAD  commands. 

CLEAR  POPUPS  erases  all  pop-up  menus  from  the  screen  and  releases  them 
from  memory.  CLEAR  POPUPS  also  clears  all  pop-up  menu  ON  SELECTION 
com  mands. 
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CLEAR  WINDOW  deactivates  all  windows,  erases  them  from  the  screen,  and 
releases  them  from  memory.  Any  text  obscured  by  an  activated  window  is 
restored. 

COMPILE  <  filename  >  [RUNTIME]  searches  for  a  program  source  (  prg) 
file  and  generates  a  program  object  (.dbo)  file  with  the  same  filename.  Pro¬ 
gram  object  (.dbo)  files  are  pre-parsed,  so  execution  speed  is  greatly 
increased  with  their  use.  If  the  RUNTIME  option  is  specified,  the  compiler 
will  print  an  error  when  it  encounters  a  command  that  is  not  legal  for  Run¬ 
Time. 

CONVERT  [TO  <  expN >  ]  adds  a  field  to  a  database  structure  which  con¬ 
tains  information  required  to  do  multi-user  lock  holder  identification  and 
change  detection.  Upon  execution,  CONVERT  adds  the  _DBASELOCK  field 
to  the  selected  database.  _DBASELOCK  is  required  to  use  the  new 
CHANGE()  and  LKSYS()  functions. 

COPY  INDEXES/TAG  <  NDX  file  list  >  /  <  tag  list  >  (TO 
<  MDX  name.mdx>  ]  creates  .mdx  tags  in  <  MDX  filename  >  with  the 
same  key  expression  as  each  .ndx  filename  or  mdx  tag  specified. 

t  COPY  MEMO  <  memo  field  name>  TO  <  filename  >  [ADDITIVE]  copies 

the  named  memo  field  to  a  new  file,  or  adds  the  memo  to  an  existing  file  if 
the  ADDITIVE  keyword  is  used. 

COPY  STRUCTURE  EXTENDED  TO  <  filename  >  produces  a  database  file 
containing  the  new  index  option  database  field  attribute  in  addition  to  field 
number,  name,  type,  and  size. 

COPY  TAG  <  MDXtag>  [OF  <  MDX  name>  ]  TO  <  ndx  filename. ndx  > 
creates  a  new  .ndx  file  with  the  same  key  expression  as  the  mdx  tag. 

COPY  TO  <  new  file>  [<  scope  >  ]  [HELDS  <  field  list>  ]  [FOR 
<  condition  >  ]  [WHILE  <  condition  >  ]  [[TYPE]  SDF/DIF/SYLK/ WKS/ 
FW2/RPD/dBASEII/DELIMITED  [WITH  BLANK/  <  delimiter  ]]  now  sup¬ 
ports  Framework  II,  LOTUS  1-2-3,  RapidFile,  and  dBASE  II  file  types. 

COPY  TO  ARRAY  <  array  name>  [<  scope  >  ]  [HELDS  <  field  list  >  ] 

[FOR  <  condition  >  ]  [WHILE  <  condition  >  ]  replaces  the  values  of  one  or 
more  array  elements  in  the  existing  named  array  with  fields  from  the  data¬ 
base  file  currently  in  USE. 

CREATE  APPLICATION  <  filename  >  /?  invokes  the  Applications  Generator 
from  the  dot  prompt. 

CREATE  <  new  file>  FROM  <  structure  extended  file  >  now  creates  a 
database  structure  containing  the  index  database  field  attribute  in  addition  to 
the  field  name,  type,  length,  and  decimal  places  (if  applicable). 

CREATE  <  filename  >  now  accepts  both  F  and  N  data  types  for  fixed  and 
floating  point  numbers,  and  will  also  accept  the  new  index  field  database 
field  attribute. 

DBLINK  <  filename  >  /L  is  a  stand-alone  programAthe  dBASE  IV  Develop¬ 
er’s  Edition  capable  of  joining  together  up  to  256  related  program  object 
(.dbo)  files  into  a  single  object  file  for  faster  execution.  DBLINK  will  auto¬ 
matically  join  together  any  compiled  command  and  procedure  files  refer¬ 
enced  in  <  filename  >  or  other  files  called  by  <  filename  >  . 
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DEACTIVATE  MENU  deactivates  the  active  horizontal  bar  menu  and  erases  it 
from  the  screen,  but  does  not  release  it  from  memory. 

DEACTIVATE  POPUP  deactivates  the  active  pop-up  menu  and  erases  it  from 
the  screen,  but  does  not  release  it  from  memory. 

DEACTIVATE  WINDOW  <  window  name  list >  /ALL  deactivates  and  clears 
the  specified  windows  from  the  screen.  Any  text  obscured  by  a  window  when 
the  window  was  activated  is  restored.  Any  previously  activated  window  is 
reactivated,  or  dBASE  IV  reverts  to  full-screen  input  and  output.  Deactivated 
windows  are  not  cleared  from  memory,  and  may  be  reactivated  at  any  time. 

DEBUG  <  filename  >  /<  procedure  name>  [WITH  <  parameter  list  >  ] 
invokes  dBASE  IV’s  new  built-in  debugger  on  the  specified  file. 

DECLARE  <  array  definition  list  >  creates  the  arrays  specified  in  the  array 
definition  list  and  sets  aside  a  memory  variable  location  for  each  element  of 
each  array.  Arrays  may  contain  up  to  two  dimensions.  The  maximum  num¬ 
ber  of  array  elements  is  limited  only  by  the  amount  of  available  memory. 

DEFINE  BAR  <  expN>  OF  <  popup  name>  PROMPT  <  expC> 

[MESSAGE  <  expC>  ]  [SKIP  [FOR  <  condition  >  ]]  is  used  to  specify  a  sin¬ 
gle  option  on  a  pop-up  menu. 

DEFINE  BOX  FROM  <  rowl>  ,  <  coll>  TO  <  row2>  ,  <  col2> 

HEIGHT  <  expN  >  [AT  LINE  <  expN>  ]  [SINGLE/ DOUBLE/ 'border  defini¬ 
tion  string*]  establishes  parameters  for  a  graphic  box  to  be  drawn  on  the 
printer  with  subsequent  lines  of  output. 

DEFINE  MENU  <  menu  name>  [MESSAGE  <  expC>  ]  allows  you  to 
define  a  horizontal  bar  menu. 

DEFINE  PAD  <  pad  name>  OF  <  menu  name>  PROMPT  <  expC>  [AT 

<  row  >  ,  <  col>  ]  [MESSAGE  <  expC>  ]  allows  you  to  define  a  single  hor¬ 
izontal  bar  menu  option. 

DEFINE  POPUP  <  popup  name>  FROM  <  rowl>  ,  <  coll>  [TO 

<  row2 >  ,  <  col2 >  ]  [PROMPT  FIELD  <  field  name>  /FILES  [LIKE 

<  skeleton  >  ]  } 

(J STRUCTURE]  [MESS AGE  <  expC>  ]  is  used  to  easily  create  pop-up  menus 
under  program  control. 

DEFINE  WINDOW  <  window  name>  FROM  <  rowl>  ,  <  coll>  TO 

<  row2 >  ,  <  col2 >  [DOUBLl/PANEL/NONE/'border  definition  string'] 
[COLOR  [<  standard  >  ]  [,<  enhanced  >  ]  [,<  frame  >  ]]  allows  you  to  spec¬ 
ify  the  name,  size,  colors,  and  border  pattern  of  a  window,  and  its  location 
on  the  screen.  Up  to  20  windows  may  be  DEFINEd  simultaneously. 

DELETE  TAG  <  MDXtagl  >  [OF  <  MDX  name>  ]/[<  NDXtagl  >  ] 

[,<  MDXtag2>  [OF  <  MDX  name>  ]/ <  NDXtag2>  ....]  removes  the  speci¬ 
fied  index  tag  from  the  specified  .mdx  files  or  closes  the  indicated  .ndx  files. 

DISPLAY  [<  scope  >  ]  [[FIELDS]  <  expression  list  >  ]  [OFF] 

[TO  PRINTER/TO  FILE  <  filename  >  ]  [WHILE  <  condition  >  ]  [FOR 

<  condition  >  ]  has  been  enhanced  to  support  the  TO  PRINTER/TO  FILE 

<  filename  >  option. 


2-4 


SUMMARY  OF  MODIFIED  COMMANDS  AND  FUNCTIONS 


NAME:  PAGE:  5  SESS:  4  Hon  Apr  4  23:51:27  1988 

t«/di  sK2/»l  I  J  obz/CLS_fn«nh»t/GRPjnanh»t/J08_rn«nchg*um/0iy_csch»p2 

DISPLAY  FILES  [LIKE  <  skeleton  >  ]  [TO  PRINTER/TO  FILE 

<  filename  >  ]  has  been  enhanced  to  support  the  TO  PRINTER/TO  FILE 

<  filename  >  option. 

DISPLAY  HISTORY  [LAST  <  expN>  ]  [TO  PRINTER/TO  FILE 

<  filename  >  ]  now  supports  the  TO  PRINTER/TO  FILE  <  filename  > 
option. 

DISPLAY  MEMORY  [TO  PRINTER/TO  FILE  <  filename  >  ]  has  been 
enhanced  to  show  window  names,  pop-up  menu  names,  horizontal  bar  menu 
names  and  PADS,  and  the  memory  consumed  by  each.  This  is  in  addition  to 
memory  variable  names,  data  types,  contents,  and  the  amount  of  available 
memory  left. 

CblSPLAY  MEMORY  now  also  supports  the  TO  PRINTER/TO  FILE 

<  filename  >  option. 

DISPLAY  STATUS  [TO  PRINTER/FILE  <  filename  >  ]  has  been  modified  to  \y 
display  both  MDX  and  NDX  information  and  now  supports  the  TOlPRINTER/  ^ 
/FILE  <  filename  >  option. 

DISPLAY  STRUCTURE  [TO  PRINTER/TO  FILE  <  filename  >  ] 

[IN  <  alias  name>  ]  has  been  enhanced  to  display  a  database  structure  in  a 
work  area  other  than  one  currently  selected,  and  now  supports  the  TO  PRIN¬ 
TER/TO  FILE  <  filename >  option. 

DO  <  program  filename  >  /.<  procedure  name>  [WITH  <  parameter 
list  >  ]  now  supports  an  optional  list  of  parameters  to  be  passed  to  the  called 
program  or  procedure  file. 

EDIT  has  been  improved  to  provide  all  the  features  described  under  the 
BROWSE  command. 

ENDPRINTJOB  sends  the  ending  printer  codes  (defined  by  the  _pecodes  sys¬ 
tem  memvar)  to  the  printer,  performs  an  EJECT  if  required  by  the  _peject 
system  memvar,  and  loops  back  to  the  PRINTJOB  statement  for  the  number 
of  copies  required  by  the  _pcopies  system  memvar.  Please  see  PRINTJOB 
for  more  information. 

END  TRANSACTION  terminates  an  active  transaction.  Please  see  BEGIN 
TRANSACTION  for  more  information. 

ENDSCAN  closes  off  an  active  SCAN  loop.  Please  see  SCAN  for  more 
inform  ation. 

EXPORT  TO  <  filename  >  [FIELDS  <  field  list  >  ]  [<  scope  >  ]  [FOR 

<  condition  >  ]  [WHILE  <  condition  >  ]  [TYPE]  [PFS/FW2/RPD/dBASEII] 
now  supports  FW2  (Framework  II),  RPD  (RapidFile),  and  dBASEII 
(dBASE  II)  file  types  in  addition  to  the  PFS  file  type. 

FUNCTION  <  function  name>  is  used  to  declare  a  user-defined  function. 
User-defined  functions  must  begin  with  FUNCTION. 

GO/GOTO  BOTTOM/ [RECORD]  <  expN>  /TOP  [IN  <  alias  name>  ]  has 
been  enhanced  to  move  the  record  pointer  in  a  work  area  other  than  one 
currently  selected. 

IMPORT  FROM  <  filename  >  [TYPE]  [PFS/WKl/FW2/RPD/dBASEII]  now 
supports  WK1  (LOTUS  1-2-3),  FW2  (Framework  II),  RPD  (RapidFile),  and 
dBASEII  (dBASE  II)  file  types  in  addition  to  the  PFS  file  type. 
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INDEX  [ON  <  key  expression  >  ]  [TO  <  index  file  >  ]  /  [[TAG  <  MDXtag>  ] 
[OF  <  MDXname  >  ]]  [UNIQUE]  (DESCENDING]  has  been  vastly  enhanced 
to  allow  for  the  creation  of.mdx  files  and  greatly  reduced  execution  time  as 
well  as  descending  index  tags  in  an  .mdx  file.  Specifying  the  TO 

<  NDX  filename. ndx  >  option  will  create  a  dBASE  III  PLUS  type  .ndx  file, 
while  specifying  TAG  <  tag>  will  create  a  new  tag  in  the  specified  .mdx  file. 
If  the  .mdx  file  does  not  exist,  it  is  created. 

LABEL  FORM  <  label  filename  >  /?  ( <  scope  >  ]  [FOR  <  condition  >  ] 
[WHILE  <  condition  >  ]  [SAMPLE]  [TO  PRINTER/TO  FILE  <  filename  >  ] 
now  supports  the  TO  FILE  <  filename >  option  which  directs  label  output 
to  the  named  text  file. 

LIST  —  now  supports  TO  FILE  <  filename >  in  every  instance  to  facilitate 
printed  output. 

LIST  MEMORY  has  been  enhanced  to  show  window  names,  pop-up  menu 
names,  horizontal  bar  menu  names  and  PADS,  and  the  memory  consumed  by 
each,  in  addition  to  memory  variable  names,  data  types,  contents,  and  the 
amount  of  available  memory  left. 

LOGOUT  clears  memory  variables  and  resets  other  internal  dBASE  IV 
parameters.  LOGOUT  is  available  in  both  single-  and  multi-user  modes. 

MODIFY  APPLICATION  <  filename  >  /?  invokes  the  Applications  Generator 
from  the  dot  prompt. 

MODIFY  COMMAND/ FILE  <  filename  >  [WINDOW  <  window  name>  ] 
will  now  search  for  a  program  object  (.dbo)  file  of  the  same  name  as  a  pro¬ 
gram  source  (.prg)  file  and  delete  the  old  .dbo  file  when  a  new  version  of  the 
.prg  file  is  saved.  In  this  way,  the  .dbo  files  on  disk  will  always  represent  the 
latest  version  of  a  prg  or  will  be  deleted.  MODIFY  COMMAND  will  delete  an 
older  version  of  a  .dbo  even  if  an  alternate  text  editor  is  specified  in 
Contig.db. 

MODIFY  COMMAND  also  now  supports  the  WINDOW  <  window  name> 
option,  allowing  the  editor  to  operate  within  a  user-defined  window  area. 

MODIFY  STRUCTURE  will  now  accept  both  N  (fixed  point)  and  F  (floating 
point)  numeric  data  types.  If  a  database  structure  is  modified  with  index  files 
open,  the  indexes  are  now  checked  for  validation  and  maintained  accord¬ 
ingly.  MODIFY  STRUCTURE  also  accepts  the  new  database  index  field 
attribute. 

MOVE  WINDOW  TO  <  row  1  >  ,  <  coll  >  /BY  <  delta  row  >  ,  <  delta  col  > 
moves  the  active  window  to  the  new  absolute  position  specified  by _ 

<  row  1  >  ,  <  coll  >,  or  the  new  relative  position  specified  by  '  ‘  "" 

<  delta  row  >  ,  <  delta  col>  .  MOVE  WINDOW  TO  also  updates  the  window 
definition  in  memory  to  indicate  the  final  coordinates. 

ON  KEY  [  <  key  label  name>  ]  [<  comraand>  ]  has  been  enhanced  to  trap 
specific  keys.  Function  keys,  shifted  function  keys,  All-function  keys, 
Ctri-function  keys,  and  all  other  special  keys  available  on  the  keyboard  may 
be  trapped  with  ON  KEY  by  using  unique  key  labels. 
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ON  PAD  <  pad  name  >  OF  <  menu  name  >  [ACTIVATE  POPUP 

<  popup  name>  ]  defines  which  pop-up  menu  will  be  activated  when  the 
selection  bar  is  positioned  to  the  prompt  pad  of  the  specified  menu. 

ON  PAGE  [AT  LINE  <  expN  >  <  comm  and  >  ]  allows  you  to  specify  the 
action  to  be  taken  at  a  page  break. 

ON  READERROR  [<  command  >  ]  executes  the  command  when  invalid 
RANGE  or  VALID  conditions  occur,  or  when  an  invalid  date  is  entered  into  a 
date  variable.  ON  READERROR  without  arguments  disables  RANGE  and 
VALID  checking. 

ON  SELECTION  PAD  <  pad  name>  OF  <  menu  name>  [<  command  >  ] 
indicates  the  action  to  be  taken  when  a  selection  is  made  from  a  horizontal 
bar  menu  previously  DEFINEd  and  ACTIVATEd. 

ON  SELECTION  POPUP  <  popup  name>  /ALL  [<  command>  ]  indicates 
the  action  to  be  taken  when  a  selection  is  made  from  a  pop-up  menu  previ¬ 
ously  DEFINEd  and  ACTIVATEd. 

PLAY  MACRO  <  macro  name>  will  replay  the  designated  keyboard  macro. 

PRINTJOB  defines  the  beginning  of  a  print  job.  PRINTJOB  sends  the  starting 
printer  codes  (defined  by  the  _pscodes  system  memvar)  to  the  printer  and 
performs  an  EJECT  if  required  by  the  _peject  system  memvar. 

PROTECT  is  no  longer  an  external  utility,  and  is  immediately  available  from 
both  the  dot  prompt  and  Control  Center. 

PUBLIC  <  memory  variable  list >  /[ARRAY  <  array  definition  list >  ]  can 
now  declare  both  memory  variables  and  arrays  to  be  PUBLIC. 

REINDEX  has  been  enhanced  to  support  .mdx  files  and  tags. 

RELEASE  MENUS  [<  menu  name  list >  ]  releases  the  named  horizontal  bar 
menus  and  any  associated  ON  PAD  and  ON  SELECTION  commands  from 
memory. 

RELEASE  POPUPS  [<  popup  name  list >  ]  releases  the  named  pop-up  menus 
and  any  associated  ON  SELECTION  commands  from  memory. 

RELEASE  WINDOWS  [<  window  name  list >  ]  deactivates  the  specified  win¬ 
dows,  restores  any  text  obscured  by  the  windows,  and  releases  the  window 
definition  from  memory. 

REPLACE  [<  scope  >  ]  [FOR  <  condition  >  ]  [WHILE  <  condition  >  ] 

<  field  >  WITH  <  exp  >  [ADDITIVE]  [,<  field  >  WITH  <  exp> 
[ADDITIVE]....]  will  now  automatically  convert  between  character  strings 
and  memo  fields  and  vice  versa.  In  addition,  the  ADDITIVE  clause  may  now 
be  used  with  each  memo  field  REPLACEd  to  build  up  memo  fields  from  sev¬ 
eral  character  strings. 

REPORT  FORM  <  report  form  filename  >  /?  [PLAIN]  [HEADING  <  expC>  ] 
[NOEJECT]  [SUMMARY]  [<  scope  >  ]  [FOR  <  condition  >  ]  [WHILE 

<  condition  >  ]  [TO  PRINTER/TO  FILE  <  filename  >  ]  now  supports  the  TO 
FILE  <  filename  >  option  which  directs  report  output  to  the  named  text 
file. 

RESET  [IN  ALIAS  <  alias  name>  ]  resets  the  integrity  (transaction  in 
progress)  flag  in  the  specified  database  header. 


CHANGE  SUMMARY 


2-7 


JOBNAME:  PAGE:  8  SESS:  4  non  Apr  4  23:51:27  1988 

®tate/d  i  sk2/a  l  t  j  obz/CLS_manhat/GRP_manhat/ JOB_n»anchgsum/DI  V_cschap2 

RESTORE  MACROS  FROM  <  macro  file  >  retrieves  the  macros  contained 
in  the  specified  macro  file. 

RESTORE  WINDOW  <  window  name  list >  /ALL  FROM  <  window  file  > 
restores  either  all  or  the  specified  window  definitions  previously  saved  with 
the  SAVE  WINDOW  command. 

RETURN  [TO  MASTER]  [<  exp  >  ]  has  been  enhanced  to  return  an  expres¬ 
sion  when  used  in  conjunction  with  a  user-defined  function. 

ROLLBACK  [<  database  filename  >  ]  attempts  to  restore  each  database  and 
index  file  involved  in  the  current  transaction  to  its  state  prior  to  the  initia¬ 
tion  of  the  last  BEGIN  TRANSACTION  command. 

SAVE  MACROS  TO  <  macro  file  >  will  save  any  defined  macros  to  the  speci¬ 
fied  macro  file.  If  no  file  extension  is  given,  the  file  is  given  the  default  .mcr 
extension. 

SAVE  WINDOW  <  window  name  list>  /ALL  TO  <  window  file  >  saves 
either  ALL  or  the  named  window  definitions  to  the  specified  window  file.  If 
no  file  extension  is  given,  the  file  is  given  the  default  .win  extension. 

SCAN  [<  scope  >  ]  [FOR  <  condition  >  ]  [WHILE  <  condition  >  ] 

[<  commands >  ]  [EXIT]  [LOOP]  ENDSCAN  establishes  a  loop  to  process 
database  records  meeting  the  specified  condition.  SCAN/ENDSCAN  is  similar 
to  DO  WHILE/ENDDO,  but  affords  more  flexibility  in  programming  and 
offers  cleaner  syntax. 

SHOW  MENU  <  menu  name>  [PAD  <  pad  name>  ]  displays  a  previously 
defined  horizontal  bar  menu  on  the  screen  without  activating  it. 

SHOW  POPUP  <  popup  name>  displays  a  previously  defined  pop-up  menu 
on  the  screen  without  activating  it. 

SKIP  [<  expN>  ]  [IN  <  alias  name>  ]  has  been  enhanced  to  move  the 
record  pointer  in  a  work  area  other  than  one  currently  selected. 

SORT  [  <  scope  >  ]  TO  <  new  filename  >  ON  <  field  name>  [/A]  [/C]  [/ D] 
[,  <  field2  >  [/A]  [/C]  [/D]  ....]  [WHILE  <  condition  >  ]  [FOR 

<  condition  >  ]  [ASCENDING/ DECENDING]  now  supports  both  ASCEND¬ 
ING  and  DEFENDING  options.  ^ 

SUM  [  <  expN  list  >  ]  [<  scope  >  ]  [FOR  <  condition  >  ]  [WHILE 

<  condition  >  ]  [TO  <  memvar  list >  /TO  ARRAY  <  array  name>  ]  replaces 
the  values  of  one  or  more  memory  variables  or  array  elements  in  an  existing 
array  with  the  computed  sums  of  the  specified  database  elements. 

TYPE  <  filename  >  [TO  PRINTER]  [NUMBER]  has  a  new  option  to  insert 
line  numbers  in  a  displayed  or  printed  file.  A  page  heading  showing  the  file¬ 
name,  date,  and  page  number  is  automatically  included  unless  SETTIEAD- 
ING  is  OFF.  L - 

UNLOCK  [ALL]  [IN  <  alias  name>  ]  has  been  enhanced  to  release  record  or 
file  locks  in  a  work  area  other  than  one  currently  selected. 
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USE  [<  DBF  namo  /?]  [IN  <  waexpN>  ]  [[INDEX  <  NDXfilel>  / 

<  MDXfilel  >  [,<  NDXfile2/MDXfile2>  ....]]  [ORDER  <  NDXtag>  / 

<  MDXtag>  [OF  <  MDX  nano  ]]]  [ALIAS  <  alias  nano  ]  has  been 
enhanced  to  support  .mdx  files  and  allow  databases  to  be  opened  in  a  work 
area  other  than  the  one  currently  selected.  USE  also  has  a  new  ORDER 
option  which  allows  the  master  or  controlling  index  to  be  specified  when  the 
database  is  opened. 


SET  Commands 


NOTE 

For  commands  that  are  SET  either  ON  or  OFF,  the  default  setting  is 
shown  in  upper-case  letters. 


SET  ALTERNATE  TO  [<  filename  >  ]  [ADDITIVE]  now  supports  an  optional 
ADDITIVE  keyword  that  allows  extending  existing  text  files  with  new  output. 
Use  of  the  ADDITIVE  keyword  appends  output  to  the  end  of  an  existing 
ALTERNATE  file  instead  of  creating  a  new  file. 

SET  AUTOSAVE  on/OFF  controls  when  the  contents  of  memory  buffers  are 
written  to  disk.  SET  AUTOSAVE  ON  causes  memory  buffers  to  be  automati¬ 
cally  written  to  disk  and  the  disk  file  allocation  table  and  directory  to  be 
updated  when  a  buffer  is  changed.  SET  AUTOSAVE  OFF  requires  that  data¬ 
bases  and  related  files  be  closed  before  final  buffer  contents  are  written  to 
disk. 

SET  BELL  TO  [<  frequency  >  ,  <  duration  >  ]  allows  you  to  modify  the  tone 
and  duration  of  the  bell. 

SET  BLOCKSIZE  TO  <  expN >  determines  the  block  size  of  newly  created 
index  and  memo  files.  <  expN >  may  range  from  1  to  32,  and  the  actual 
block  size  is  <  expN?  *512. 

SET  BORDER  TO  [SINGLE/DOUBLE/PANEL/NONE/' border  definition 
string']  allows  you  to  change  the  characters  used  to  define  the  borders  of 
windows,  boxes,  pop-ups,  menus,  and  lines. 

SET  CARRY  TO  [<  field  list >  ]  [ADDITIVE]  selects  the  fields  to  be  copied 
forward  when  using  APPEND,  INSERT,  and  BROWSE.  Using  the  ADDITIVE 
keyword  adds  the  specified  fields  to  those  already  specified  in  a  previous  SET 
CARRY  TO  command. 

SET  CLOCK  on/OFF  determines  whether  the  system  clock  is  displayed  on 
the  screen.  The  system  clock  is  always  displayed  when  using  BROWSE  or  the 
Control  Center. 

SET  CLOCK  TO  [<  row  >  ,  <  col>  ]  indicates  where  the  system  clock  is  dis¬ 
played  when  SET  CLOCK  is  ON. 

SET  COLOR  OF  TEXT/ HEADING/ BOX/ STATUS/ HELDS  TO  [<  standard  >  ] 
[,<  enhanced  >  ]  has  been  added  to  dBASE  IV  to  allow  you  to  easily  select 
the  colors  used  in  text,  headings,  boxes,  and  the  like. 
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SET  CURRENCY  LEFT/right  determines  whether  the  currency  symbol 
appears  to  the  left  or  right  of  currency  amounts. 

SET  CURRENCY  TO  [<  expC>  ]  changes  the  symbol  used  for  the  currency 
character.  CURRENCY  defaults  to  a  dollar  sign  (S),  but  may  be  any  string  up 
to  nine  characters  long. 

SET  DATE  [TO]  AMERICAN/ansi/british/ french/germ an/italian/japan/usa 
/mdy/dmy/ymd  now  supports  a  greatly  expanded  variety  of  date  formats. 

SET  DESIGN  ON/ofF  allows  developers  to  prevent  users  from  entering  data¬ 
base,  form,  label,  program,  or  report  design  modes.  With  SET  DESIGN, 
developers  can  confidently  use  the  Control  Center  as  a  front-end  to  a^appli- 
cation.  ^ — ' 

SET  DEVELOPMENT  on/OFF  controls  whether  dBASE  IV  will  compare  the 
creation  date  and  time  of  an  existing  program  object  (.dbo)  file  with  its 
related  program  source  (.prg)  file  and  recompile  the  .prg  file  if  the  object  file 
is  older  than  the  source  file. 

SET  DEVICE  TO  SCREEN/ PRINTER/ FILE  <  filename  >  now  supports  the 
FILE  <  filename  >  option  in  addition  to  SCREEN  and  PRINTER  to  send  the 
result  of  @  <  row  >  ,  <  col>  SAY  ....  commands  to  a  text  file. 

SET  DISPLAY  TO  MONO/ COLOR/ EGA25/EGA43/M0N043  now  allows  you 
to  specify  the  type  of  video  display  monitor  being  used. 

SET  DOHISTORY  on/OFF  has  been  retained  for  compatibility  with 
dBASE  III  PLUS,  but  performs  no  function  in  dBASE  IV.  SET  DOHISTORY 
is  no  longer  necessary  with  dBASE  IV’s  enhanced  debugger. 

SET  EMACROS  on/OFF  controls  whether  macro  expansions  may  be  used  for 
almost  any  part  of  a  single  command,  or  whether  macro  expansion*  are  lim¬ 
ited  to  only  legal  expressions  or  sub-expressions.  If  SET  EMACROS  is  ON^ 
only  expression  macros  will  be  valid,  allowing  for  greatly  reduced  execution 
time.  With  SET  EMACROS  OFF,  macro  usage  is  unrestricted. 

SET  [FIELDS  TO  <  field  >  [/R/ <  calculated  field  id  >  ....][,<  field > 

[/ R/  <  calculated  field  id  >  ....]  ..../ALL  [LIKE/ EXCEPT  <  skeleton  >  ]] 
now  may  use  calculated  fields  and  designate  a  field  as  read-only.  SET 
FIELDS  TO  also  now  supportr  the  use  of  a  wildcard  skeleton  to  select  which 
fields  are  active. 

SET  FIXED  ON/off  has  been  retained  for  compatibility  with  dBASE  III  PLUS, 
but  performs  no  function  in  dBASE  IV.  Since  dBASE  IV  has  full  floating 
point  arithmetic,  the  SET  FIXED  command  is  unnecessary. 

SET  FUNCTION  <  exp>  TO  <  expC>  [;]  now  provides  programmable  Ctri- 
and  Shift- function  keys  in  addition  to  the  standard  function  keys. 

SET  HOURS  TO  [12/24]  determines  whether  a  12-hour  clock  or  24-hour  sys¬ 
tem  clock  format  is  used. 

SET  INDEX  TO  <  list  of  ndx  or  mdx  filenames  >  /?  [ORDER  <  NDXfile>  / 
TAG  <  MDXtag>  [OF  <  MDX  name>  ]]  has  been  enhanced  to  support 
.mdx  files  and  now  supports  an  ORDER  option  to  designate  which  index  file 
or  tag  will  be  the  master  or  controlling  order. 

SET  INSTRUCT  ON/off  controls  whether  time-delayed  pop-up  information 
boxes  appear  after  a  full-screen  command  is  issued. 
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SET  LOCK  ON/off  controls  whether  dBASE  IV  will  perform  automatic  file 
and  record  locking  before  processing  commands  that  are  “read  only”  (such 
as  AVERAGE,  CALCULATE,  and  REPORT)  in  a  multi-user  environment. 

SET  MARK  TO  [<  expC>  ]  changes  the  delimiter  used  to  separate  the 
month,  day,  and  year  when  dates  are  displayed  or  entered.  The  default  char¬ 
acter  depends  on  the  setting  of  the  SET  DATE  command;  for  example,  SET 
MARK  TO  establishes  the  slash  character  (/)  as  the  delimiter  to  be  used  if  the 
SET  DATE  TO  USA  command  is  in  effect. 


SET  MENTIS  ON/off  has  been  retained  for  compatibility  with 

dBASE  III  t'LUb,  out  performs  no  luintion  in  Uri  AShTV.  ihe  enhanced  Help 

system  in  dBASE  IV  replaces  SET  MENUS  in  dBASE  III  PLUS. 

SET  NEAR  on/OFF  determines  the  position  of  the  record  pointer  after  an 
unsuccessful  SEEK  or  FIND  command.  Following  an  unsuccessful  SEEK  or 
FIND  with  SET  NEAR  OFF,  dBASE  IV  will,  like  dBASE  III  PLUS,  position 
the  record  pointer  to  the  end-of-file  and  set  the  EOF()  flag  to  a  logical  true 
(.T.).  SET  NEAR  ON,  however,  will  position  the  pointer  to  the  first  record 
following  the  computed  position  of  the  desired  search  key  in  the  controlling 
index. 

SET  ORDER  TO  [<  expN>  ]/[TAG  <  MDXtag>  [OF  <  MDX  name>  ]]  has 
been  enhanced  to  support  .mdx  files  as  well  as  .ndx  files. 

SET  POINT  TO  [<  expC>  ]  changes  the  symbol  displayed  as  the  decimal 
point  character.  The  default  is  a  period. 

SET  PRECISION  TO  [  <  expN  >  ]  determ  ines  the  precision  of  fixed  point 
numbers  in  dBASE  IV.  The  precision  may  be  set  between  10  and  20.  The 
default  precision  is  16.  A  different  default  precision  may  be  specified  in  the 
Config.db  file. 

SET  PRINTER  TO  [  <  DOS  device  >  /FILE  <  filename  >  / \\ <  computer 
name>  /<  printer  name>  -  <  destination  >  /\\spooler]  affords  control 
over  the  destination  of  printed  output  and  network  spoolers. 

SET  REFRESH  TO  <  expN>  works  in  conjunction  with  BROWSE  and  EDIT 
to  set  the  number  of  seconds  between  automatic  checks  of  the  database  file 
in  USE  for  changes  made  by  another  user.  If  another  user  has  changed  the 
data,  dBASE  IV  will  automatically  display  the  changed  data  on  your  screen. 

SET  RELATION  TO  [  <  expl  >  /  <  expN  >  INTO  <  alias  name  >  ] 

[,<  exp2>  INTO  <  alias  name2>  ....]  now  supports  multiple  child  rela¬ 
tions  with  a  single  command. 

SET  REPROCESS  TO  <  expN>  allows  you  to  select  how  many  times  a 
multi-user  process  should  be  attempted  before  dBASE  IV  returns  a  network- 
related  error.  The  maximum  number  of  retries  for  SET  REPROCESS  is 
32,000. 

SET  SEPARATOR  TO  [<  expC>  ]  changes  the  symbol  displayed  as  the 
numeric  separator  character  (between  thousands).  The  default  numeric  sepa¬ 
rator  is  a  comma. 
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SET  SKIP  TO  [<  alias  name  1  >  [,  <  alias  name2 >  ....]]  changes  the  way 
the  record  pointer  is  positioned  when  processing  related  database  files. 

When  used  with  SET  RELATION,  SET  SKIP  causes  the  record  pointer  in  the 
specified  databases  to  be  advanced  before  the  record  pointer  in  the  primary 
database  is  advanced.  This  allows  access  to  multiple  occurrences  of  the  same 
key  in  linked  files. 

SET  SPACE  ON/off  controls  whether  a  space  is  generated  between  fields  sep¬ 
arated  by  a  comma  in  the  ?  [<  expression  list >  ]  and  ??  [<  expression 
list >  ]  commands. 

SET  SQL  on/OFF  controls  dBASE  IV’s  new  interactive  SQL  mode  from  the 
dot  prompt.  Please  refer  to  the  Using  dBASE IV SOL  manual  for  complete 
information  on  using  SQL  with  dBASE  IV. 

SET  TRAP  on/OFF  controls  whether  the  debugger  is  invoked  when  an  error 
occurs  or  the  Esc  key  is  pressed  during  program  execution.  SET  TRAP  ON  to 
invoke  the  debugger  automatically;  SET  TRAP  OFF  to  handle  errors  in  the 
usual  fashion. 

SET  VIEW  TO  <  filename  >  /?  now  works  in  concert  with  CATALOG.  When 

a  dBASE  III  PLUS  .vue  file  is  updated  in  dBASE  IV,  the  resulting  file  is  saved  _ _ 

as  a  program  object  (  dbo)  file  and  used  with  the  DO  <  filename >} 

Ccommand.  The  updated  doo  hies  cannot  oe  used  with  dBASE  III  PLUS.  V 

SET  WINDOW  OF  MEMO  TO  <  window  name>  sets  the  default  window  for 
editing  memo  fields  to  <  window  name>  when  using  the  BROWSE  or  EDIT 
com  mands. 


Functions 

ACCESSQ  returns  a  user’s  access  level  (1  to  8)  when  dBASE  IV  was  started 
using  the  PROTECT  log-in  security  features. 

ACOS(<  expN  >  )  returns  the  angle  size  in  radians  with  a  trigonometric 
cosine  matching  the  specified  value. 

ALIAS ([  <  expN  >  ])  returns  the  alias  name  of  the  specified  work  area  as  an 
upper-case  character  string. 

ASIN(<  expN>  )  returns  the  angle  size  in  radians  with  a  trigonometric  sine 
matching  the  specified  value. 

AT(<  expC>  ,  <  exp>  )  may  now  take  a  memo  field  name  as  its  second 
argument. 

AEAN(<  expN>  )  returns  the  angle  size  in  radians  with  a  trigonometric  tan¬ 
gent  matching  the  specified  value. 

ATN2(<  expNl  >  ,  <  expN2>  )  returns  the  angle  size  in  radians  with  a  trigo¬ 
nometric  sine  and  cosine  matching  the  specified  values. 

BAR()  returns  the  bar  number  of  the  most  recently  selected  pop-up  menu 
option. 
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CALL(  <  expCl  >  ,  <  expC2  >  /  <  memvar  >  )  executes  one  of  the  up  to  16 
binary  modules  previously  loaded  into  dBASE  IV  through  the  LOAD  com¬ 
mand.  CALL()  returns  a  character  expression  with  the  same  length  as  the 
input  character  expression.  The  value  of  the  expression,  however,  can  be 
modified  by  the  CALLed  module. 

CEILING( <  expN>  )  returns  the  smallest  integer  greater  than  or  equal  to 
the  specified  numeric  expression. 

CHANGE()  tests  whether  the  data  in  the  current  record  has  changed  since  it 
was  read  from  disk  when  dBASE  IV  is  running  on  a  network.  CHANGEQ 
returns  a  logical  true  (.T.)  if  the  count  or  checksum  value  of  the  current 
record  is  different  than  the  value  stored  in  the  _DBASELOCK  field  created 
by  the  CONVERT  TO  <  expN>  command;  CHANGE()  returns  a  logical  false 
(.F.)  if  the  record  has  not  been  changed  since  first  read  from  disk.  See  also 
the;? 

CZCONVERT  TO  <  expN >  command  and  LKSYS(<  expN>  )  function. 

COMPLETEDQ  returns  a  logical  true  (.T.)  by  default  and  when  a  transaction 
is  successfully  ended.  COMPLETEDQ  returns  a  logical  false  (.F.)  from  the 
time  a  BEGIN  TRANSACTION  command  is  issued  until  an  END  TRANSAC¬ 
TION  command  is  executed. 

COS(<  expN  >  )  returns  the  trigonometric  cosine  of  the  specified  angle  mea¬ 
sured  in  radians. 

DIFFERENCES  expCl  >  ,  <  expC2>  )  returns  a  number  indicating  how 
close  two  SOUNDEX(<  expC>  )  are  to  each  other. 

DMY(<  expD>  )  returns  a  character  string  representation  of  the  date  vari¬ 
able  argument  in  DD  Mon  YY  format,  where  Mon  is  the  full  month  name. 
DMY(<  expD>  )  returns  the  century  and  year  in  the  form  YYYY  if  SET 
CENTURY  is  on.  For  example,  DMY({1 1/20/58})  returns  20  November  1958 
with  SET  CENTURY  ON,  and  20  November  58  with  SET  CENTURY  OFF. 

DTOR(  <  expN  >  )  converts  the  specified  number  of  degrees  to  radians. 

DTOS(<  expD>  )  converts  a  date  expression  into  an  eight-character  string 
suitable  for  use  in  an  index  without  farther  manipulation.  For  example, 
DTOS({l  1/20/58})  will  return  the  string  19581120.  The  century  is  always 
returned. 

FIXED(<  expF>  )  converts  a  data  type  F  floating  point  expression  into  a 
data  type  N  fixed  point  number. 

FLOAT(<  expN>  )  converts  a  data  type  N  fixed  point  expression  into  a  data 
type  F  floating  point  number. 

FLOOR(<  expN>  )  returns  the  largest  integer  that  is  less  than  or  equal  to 
the  specified  numeric  expression. 

FV(<  payment >  ,  <  rate>  ,  <  periods >  )  returns  the  future  value  for  the 
specified  payment,  rate,  and  number  of  periods. 

INKEY([  <  expN  >  ])  returns  an  integer  representing  the  most  recent  key 
pressed  by  the  user.  If  <  expN  >  is  specified,  dBASE  IV  will  pause 
<  expN  >  number  of  seconds  before  continuing  program  execution. 
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ISMARKED([  <  alias  name>  ])  returns  a  logical  true  (.T.)  if  any  transaction 
is  in  progress  that  may  affect  the  integrity  of  the  specified  database  or  alias, 
or  a  transaction  has  failed  but  no  ROLLBACK  has  been  executed.  A  logical 
false  (.F.)  is  returned  if  no  transaction  is  in  progress  and  the  integrity  of  the 
database  header  is  intact. 

KEY([  <  MDXfile  >  ,]  <  expN  >  [,  <  alias  name  >  ])  returns  the  key  expres¬ 
sion  of  an  index  or  mdx  tag  as  a  character  string. 

LASTKEY()  returns  the  decimal  ASCII  value  of  the  last  key  pressed  that 
exited  a  full-screen  operation  such  as  EDIT  or  READ. 

LEFT(<  exp  >  ,  <  expN  >  )  is  now  able  to  take  a  memo  field  name  or  char¬ 
acter  expression  as  its  first  argument. 

LEN(<  exp>  )  is  now  able  to  take  a  memo  field  name  or  character  expres¬ 
sion  as  its  first  argument. 

LIKE(<  pattern  >  ,  <  expC>  )  returns  a  logical  true  (.T.)  or  logical  false 
(.F.)  depending  on  whether  the  <  pattern  >  compares  with  the  <  expC> 
argument.  The  function  allows  unlimited  use  of  the  *  and  ?  wildcard  symbols 
as  part  of  the  pattern  string. 

LINENOQ  returns  the  file  relative  line  number  of  the  current  command. 

LKSYS(  <  expN  >  )  returns  either  the  time  of  lock,  date  of  lock,  or  ID  of  the 
user  who  last  locked  a  record  or  file  when  running  in  multi-user  mode. 
LKSYS(<  expN>  )  requires  the  _DBASELOCK  field  created  by  the 
CONVERT  TO  <  expN >  command  to  operate. 

LOCK([<  "expC  list >  ]  [,<  alias  name>  ])  has  been  enhanced  to  support 
locking  of  multiple  records  with  a  single  command  line.  The  maximum  num¬ 
ber  of  simultaneous  locks  has  been  increased  to  50. 

LOG10(<  expN  >  )  returns  the  base  10  logarithm  of  the  specified  numeric 
expression. 

LOOKUP(<  exp  to  return  >  ,  <  look-for  exp>  ,  <  look-in  exp>  )  searches 
the  database  containing  the  <  look-in  expression  >  for  the  first  record 
where  the  <  look-in  expression  >  matches  the  <  look-for  expression  >  .  If 
the  search  or  lookup  is  successful,  the  <  expression  to  return  >  is  returned. 

MDX(<  expN  >  [,<  alias  name  >  ])  returns  the  filename  of  the  .mdx  file 
containing  the  tag  number  <  expN >  . 

MDY(<  expD>  )  returns  a  character  string  representation  of  the  specified 
date  variable  in  Mon  DD,  YY  format,  where  Mon  is  the  full  month  name. 
MDY(<  expD>  )  returns  the  century  and  year  in  the  form  YYYY  if  SET 
CENTURY  is  on.  For  example,  MDY({1 1/20/58})  returns  Noyem <?58 
with  SET  CENTURY  ON,  and  November  20,  58  with  SET  CENTURY  OFF. 

MEMLINES( <  memo  field  >  )  returns  the  number  of  lines  a  memo  field  will 
occupy  based  on  the  current  value  of  the  SET  MEMOWIDTH  TO  <  expN  > 
command. 

MEMORY([0])  returns  the  number  of  kilobytes  of  unused  RAM  memory 
available  in  the  computer  system. 

MENU()  returns  the  name  of  the  active  or  most  recently  ACTIVATEd  horizon¬ 
tal  bar  menu. 
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MLINE(  <  memo  field  >  ,  <  expN  >  )  returns  the  text  of  the  specified  line  in 
the  memo  field,  based  upon  the  current  value  of  the  SET  MEMOWIDTH  TO 
<  expN >  command. 

NDX(  <  expN  >  [,<  alias  name>  ])  has  been  enhanced  to  return  the  names 
of  active  index  files  in  the  specified  work  area. 

NETWORK()  returns  a  logical  true  (.T.)  if  dBASE  IV-b«wh*has  been  installed 
for  network  operation  and  is  running  on  a  network,  and  a  logical  false  (.F.'1  if 
not. 

ORDER([  <  alias  name  >  ])  returns  the  name  of  the  index  file  or  .m dx  tag 
controlling  the  order  of  a  database  file  in  the  specified  work  area. 

PAD()  returns  the  name  of  the  most  recently  selected  horizontal  bar  menu 
option. 

PAYMENT(  <  principal  >  ,  <  rate  >  ,  <  periods >  )  returns  the  payment 
required  to  amortize  a  loan  with  the  specified  principal  balance,  interest 
rate,  and  number  of  periods. 

PI()  returns  the  floating  point  number  3.1415926535897932385.  The  value  of 
PI()  when  displayed  or  printed  is  specified  by  the  value  of  the  SET 
DECIMALS  TO  <  expN>  command. 

PICTURE  functions  that  have  been  added  are  L,  to  display  leading  zeros;  S, 
to  precede  a  numeric  value  with  a  currency  symbol  and  separate  thousands 
with  commas;  and  A,  to  format  an  expression  to  display  or  edit  in  exponen¬ 
tial  or  scientific  notation.  PICTURE  now  also  supports  enumerated  data 
types  with  the  M 

C.  function; 

POPUP()  returns  the  name  of  the  active  or  most  recently  ACTIVArEd  pop-up 
menu. 

PRINTSTATUSQ  returns  a  logical  true  (.T.)  if  the  printer  is  ready  to  accept 
output,  and  a  logical  false  (.F.)  if  the  printer  is  not  ready. 

PROGRAMQ  returns  the  name  of  the  program  or  procedure  being  executed. 

PROMPTQ  returns  the  PROMPT  of  the  most  recently  selected  horizontal  bar 
or  pop-up  menu  option. 

PV(<  payment  >  ,  <  rate  >  ,  <  periods  >  )  calculates  and  returns  the  present 
value  of  the  specified  payment,  interest  rate,  and  number  of  periods. 

RAND([  <  expN >  ])  returns  a  random  number  between  0  and  1. 

RAND([  <  expN>  ])  can  use  a  given  numeric  expression  for  the  seed  value, 
or,  if  the  given  numeric  expression  is  negative,  will  generate  a  seed  based  on 
the  system  clock. 

READVAR()  returns  the  name  of  the  field  or  memory  variable  currently 
being  edited  as  an  upper-case  character  string. 

RIGHT(  <  exp  >  ,  <  expN  >  )  is  now  able  to  take  a  memo  field  name  or  char¬ 
acter  expression  as  its  first  argument. 

RLOCK([  <  "expC"  list>  ]  [,<  alias  name>  ])  has  been  enhanced  to  support 
locking  of  multiple  records  with  a  single  command  line.  The  maximum  num¬ 
ber  of  simultaneous  locks  has  been  increased  to  50. 
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ROLLBACKQ  returns  a  logical  true  (.T.)  by  default  or  when  a  ROLLBACK 
[<  database  filename >  ]  command  completes  successfully.  When  aTROLL- 
BACK  [<  database  filename  >  ]  command  is  issued,  ROLLBACKQ  returns  a 
logical  false  (.F.)  until  the  ROLLBACK  [<  database  filename  >  ]  terminates 
successfully. 

RTOD(<  expN  >  )  converts  the  specified  number  of  radians  to  degrees. 

SEEK( <  exp  >  [,  <  alias  name  >  ])  is  similar  to  the  SEEK  <  exp  > 
command,  but  returns  a  logical  value  immediately  and  allows  the  use  of  an 
alias  name  as  a  second  argument.  SEEK(<  exp>  [,<  alias  name>  ])  returns 
a  logical  true  (.T.)  if  the  expression  sought  is  found  in  the  master  index  of  a 
database  file,  or  a  logical  false  (.F.)  if  not. 

SELECT([  <  expN  >  ])  returns  the  number  of  the  highest  unused  work  area 
available,  in  descending  order. 

SET(<  expC>  )  tests  the  status  of  ON/OFF  SET  parameters  and  returns  ON 
if  the  parameter  is  SET  ON,  or  OFF  if  the  parameter  is  SET  OFF. 

SET(<  expC>  )  will  return  an  error  if  the  SET  command  specified  is  not  an 
ON/OFF  SET  command. 

SIGN(<  expN>  )  returns  1  if  the  numeric  expression  is  positive,  0  if  it  is 
equal  to  zero,  and  —  1  if  the  expression  is  negative. 

SIN(<  expN  >  )  returns  the  trigonometric  sine  of  the  specified  angle  mea¬ 
sured  in  radians. 

SOUNDEX(<  expC>  )  returns  a  phonetic  character  string  code  based  on 
what  the  specified  character  string  sounds  like,  which  can  be  used  in  uncer¬ 
tain  match  lookups.  SOUNDEX(<  expC>  )  returns  the  letter,  digit,  digit, 
digit  Soundex  code  of  the  specified  character  string. 

STUFF( <  expl  >  ,  <  expNl  >  ,  <  expN2 >  ,  <  expC2 >  )  is  now  capable  of 
operating  on  memo  fields. 

SUBSTR(<  exp>  ,  <  start  >  [,<  length  >  ])  can  now  operate  on  a  memo 
field. 

TAG([<  MDX  file>  ,]  <  expN>  [,<  alias  name>  ])  returns  the  tag  name  of 
the  specified  MDX  file  as  an  upper-case  character  string. 

TAN(<  expN>  )  returns  the  trigonometric  tangent  of  the  specified  angle 
measured  in  radians. 

USER()  returns  the  name  of  the  user  (from  the  Dbsystem.db  file)  logged  into 
PROTECT. 
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Introduction 


The  Purpose  of  This  Book 

Using  the  Menu  System  is  your  guide  to  dBASE  IV’s  Control  Center  and  full¬ 
screen  commands.  It  provides  information  you’ll  need  whether  you  use  the 
Control  Center  or  dot  prompt. 

This  manual  shows  you  how  to  create  database  files,  design  screens  for  your 
data,  print  reports,  make  labels,  and  use  the  dBASE  IV  editor. 

If  you  are  not  familiar  with  dBASE  IV,  first  read  Learning  dBASE IV,  which 
provides  an  introduction  to  the  material  this  manual  covers  in  detail.  Even  if 
you  are  an  experienced  dBASE  user,  you  may  find  Learning  dBASE  IV  a  use¬ 
ful  introduction  to  the  improved  interface  for  dBASE  IV. 

Using  the  Menu  System  is  your  day-to-day  reference  source  for  the  Control 
Center  and  most  of  dBASE  IV’s  screens  and  menus. 

A  few  of  the  full-screen  aspects  of  dBASE  IV  are  covered  in  other  books 
when  appropriate.  The  dBASE  IV  screens  not  described  in  this  book  are 
shown  in  Table  1-1. 


Table  1-1  Screens  described  in  other  books 


Screen  Described  in 

Protect  Networking  with  dBASE  IV 

Debugger  Programming  with  dBASE  IV 

Settings  Language  Reference 


How  This  Book  Is  Organized 

Using  the  Menu  System  has  five  tab  sections.  The  Introduction  describes  the 
menu  system  and  the  Control  Center.  “Editing  and  Printing  in  dBASE  IV” 
explains  how  to  use  the  Browse  and  Edit  screens,  and  the  layout  and  word 
wrap  editing  modes.  This  section  concludes  with  a  description  of  how  to 
print  data  from  dBASE  IV. 
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“Designing  in  dBASE  IV”  shows  you  how  to  design  database  files,  queries, 
forms,  reports,  and  labels.  The  “Special  Menus”  section  explains  how  to  use 
the  program  editor,  the  Catalog  menu,  the  dBASE/ CHART-MASTER  Bridge 
program,  and  the  Tools  menu.  The  Appendices  provide  menu  trees,  a  func¬ 
tion  key  list,  an  editing  and  cursor  key  list,  and  a  set  of  diagrams  of  the  basic 
dBASE  IV  screens. 


Conventions  in  This  Manual 

Understanding  the  information  in  this  manual  is  much  easier  when  you 

know  the  following  conventions: 

■  The  word  press  is  used  for  keys  you  press;  the  word  type  or  enter  is  used 
for  information  you  must  type  in.  Function  keys  (in  the  dedicated  keypad 
on  your  keyboard)  are  shown  with  their  assigned  functions,  as  in  the  fol¬ 
lowing  example:  FI  Help. 

■  Commands  or  entries  that  you  type  are  in  different  type  and  in  color. 

■  Instructions  to  press  the  RETURN  or  ENTER  key  are  represented  by  the 

symbol. 

■  Menu  names  and  items,  messages  you  receive  from  the  program,  and 
other  on-screen  references  are  in  bold  type. 
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Introduction  to 
the  Menu 
System 


The  menu  system  of  dBASE  IV  consists  of  the  Control  Center,  along  with 
screens  you  can  reach  from  the  Control  Center.  You  can  also  get  to  many  of 
these  screens  from  the  dot  prompt.  You  will  find  special  manuals  that 
describe  the  dBASE  IV  Applications  Generator,  SQL,  and  the  dBASE 
programming  language. 

You  have  two  different  ways  to  accomplish  tasks  in  the  dBASE  IV  menu  sys¬ 
tem.  You  can  use  work  surfaces  or  menus.  This  chapter  describes  these  two 
parts  of  the  menu  system,  and  the  on-line  Help  system. 

The  work  surface  takes  over  the  largest  part  of  the  screen  and  gives  you  a 
place  to  edit,  display,  and  manage  your  data.  Menus  appear  at  the  top  of  the 
screen  and  contain  commands  to  help  you  carry  out  specific  tasks. 

Taken  together,  the  work  surface  and  the  menus  function  like  a  painter’s 
canvas  and  brushes.  The  combination  of  work  surfaces  and  menus  is  called 
the  menu  system. 
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The  Work  Surface 


Figure  1-1  shows  the  Edit  work  surface.  You  can  use  this  work  surface  to 
look  at  data,  change  data,  or  add  new  data. 


Records  Go  To  Exit 


NAMES  FILE 


05/ IB/ 88 


LISBONM 


Business  associate?  | 


Renewber  to  enter  area  code 


Figure  1  -1  The  Edit  work  surface 


Each  dBASE  IV  work  surface  helps  you  carry  out  a  different  task.  For  this 
reason,  each  work  surface  looks  different.  These  differences  are  described  in 
the  chapters  in  this  manual. 


Common  Work  Surface  Features 

The  screens  that  display  the  work  surfaces  have  common  features.  Figure  1-2 
shows  the  basic  parts  of  a  dBASE  IV  screen. 
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Figure  1  -2  The  parts  of  a  dBASE  IV  screen 
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The  Menu  Bar 

At  the  top  of  every  screen  is  a  menu  bar  for  the  particular  work  surface  dis¬ 
played  on  the  screen.  Menu  bars  are  discussed  in  the  “The  Menus”  section  of 
this  chapter. 

The  right  side  of  the  menu  bar  displays  a  clock  with  the  system  time.  This  is 
the  time  you  set  with  the  TIME  command  of  DOS.  Your  computer  may  have 
an  internal  clock  that  sets  this  time  automatically. 

The  Status  Bar 

The  work  surface  begins  just  below  the  menu  bar  and  takes  up  most  of  the 
screen,  extending  to  the  status  bar.  The  status  bar  provides  useful  informa¬ 
tion  about  where  you  are  in  dBASE  IV. 


*dd  fields FS  Select. F8  Move1 F7  Copy"F8  Size1 Shlft-F7  Quick  Report: Shlft-F9 

Figure  1  -3  A  typical  status  bar 


Each  section  of  the  status  bar  provides  a  certain  type  of  information.  The 
first  section  of  the  status  bar  shows  the  dBASE  IV  screen  you’re  using.  Fig¬ 
ure  1-3  is  a  reports  design  screen,  and  the  status  bar  indicates  Report.  When 
a  program  is  running,  this  section  of  the  status  bar  shows  the  name  of  the 
program . 

The  next  section  of  the  status  bar  describes  the  dBASE  IV  file  you’re  working 
with.  First  comes  the  letter  of  the  current  disk  drive,  followed  by  an  abbrevi¬ 
ated  path,  and  the  complete  filename.  The  report  in  Figure  1-3  is  named 
Midyrrpt  and  is  kept  on  drive  C,  with  a  directory  path  of 
\dbase\reptms\sales.  Its  description  in  the  status  bar  is 
C:\ . . .  salesQlDYRRPT 

The  third  section  of  the  status  bar  describes  the  location  of  the  cursor.  This 
section  depends  on  what  type  of  work  surface  you  are  using.  In  Figure  1-3, 
the  cursor  is  in  Column  31  of  the  report’s  detail  band. 

The  next  part  of  the  status  bar  shows  the  database  file  or  view  that  is  the 
source  of  the  underlying  data.  In  the  example  shown,  that  source  of  data  is  a 
view  named  Regionl.  This  section  of  the  status  bar  also  shows  multi-user 
information  on  the  Browse  and  Edit  screens.  For  example,  it  can  show  you 
that  a  record  is  locked. 
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On  the  right  side  of  the  screen,  several  indicators  provide  information  about 
your  keyboard  and  the  current  record.  On  the  Browse  and  Edit  screens,  Del 
tells  you  the  current  record  has  been  marked  for  deletion.  Num  indicates 
the  Num  Lock  key  is  set,  Caps  reveals  the  Caps  Lock  key  is  set,  and  Ins 
shows  insert  mode  is  on. 

You  can  turn  off  the  status  bar  for  the  Edit  screen  and  the  dot  prompt  with 
the  SET  STATUS  OFF  command  at  the  dot  prompt  or  the  STATUS  =  OFF  set¬ 
ting  in  your  Config.db  file.  You  can  also  turn  off  the  status  bar  with  the 
Options  menu,  which  appears  when  you  use  the  dot  prompt’s  SET 
command. 

When  the  status  bar  is  turned  off,  the  information  normally  shown  at  the 
right  of  the  status  bar  about  deletions,  insert  mode,  and  the  Num  Lock  and 
Caps  Lock  keys  is  displayed  at  the  top  of  your  screen.  The  display  of  this 
information  in  the  top  right  corner  of  your  screen  is  called  the  scoreboard.  It 
only  appears  when  the  status  bar  is  turned  off. 

You  can  turn  off  the  scoreboard  with  the  SET  SCOREBOARD  command  at 
the  dot  prompt.  You  can  also  turn  it  off  with  the  Options  menu,  which 
appears  when  you  use  the  dot  prompt’s  SET  command. 

The  Navigation  Line 

Below  the  status  bar  is  the  navigation  line.  The  information  in  this  location 
tells  you  how  to  do  important  dBASE  IV  functions.  The  information  changes 
to  fit  the  situation  on  the  screen.  For  example,  in  Figure  1-2,  the  navigation 
line  tells  you  that  to  select  a  menu  option,  you  press  <*-»■. 

The  Message  Line 

The  message  line  provides  useful  information  at  the  bottom  of  your  screen. 
When  the  cursor  is  on  a  menu  option,  the  message  line  describes  what  you 
can  do  with  that  menu  option.  When  the  cursor  is  on  a  work  surface,  the 
message  line  tells  you  about  the  highlighted  item  on  the  work  surface. 

Setting  the  Work  Surface  Colors 

There  are  several  ways  you  can  change  the  colors  used  to  display  dBASE  IV 
screens.  These  are  listed  below  with  an  indication  of  where  they  are 
described  more  fully. 

■  The  Display  option  of  the  Settings  menu  of  the  Tools  menu  bar  (in 
Chapter  14,  “Tools,”  in  this  manual) 

■  The  Display  menu  of  the  dBASE  SET  command  (in  Language  Reference 
under  the  SET  command) 

■  In  the  Config.db  file  (in  the  “Customizing  dBASE  IV”  chapter  of  Lan¬ 
guage  Reference) 

m  With  the  Display  menu  that  appears  when  you  choose  to  create  or  mod¬ 
ify  your  Config.db  file  with  DBSETUP 
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How  to  Use  Work  Surfaces 


Work  surfaces  allow  you  to  do  different  tasks,  such  as  designing  database 
files  or  editing  data.  All  work  surfaces  share  a  basic  approach  to  navigation 
and  editing,  but  since  they  allow  you  to  carry  out  different  jobs,  their  naviga¬ 
tion  procedures  differ  slightly. 

Design  and  Data 

The  dBASE  IV  Control  Center  is  built  around  a  basic  concept  about  database 
management  systems:  most  of  the  time  you  either  work  with  data  or  with 
designing.  You  may  want  to  enter,  examine,  or  edit  your  data.  Or  you  may 
wish  to  design  database  objects  such  as  database  file  structures,  forms,  and 
reports. 

These  complementary  sides  of  your  database  work  are  tied  together  by  the 
F2  Data  and  Shift-F2  Design  keys.  With  them,  you  can  switch  smoothly 
between  one  type  of  task  and  the  other. 

Suppose  you’re  designing  a  new  label  and  would  like  to  check  the  last  names 
of  a  few  employees  in  your  file  to  find  out  how  much  space  to  allocate.  Sim¬ 
ply  press  F2  Data  to  see  your  data. 

Maybe  you’re  looking  at  your  data  and  realize  you’d  like  to  concentrate  on 
just  those  clients  who  live  in  Michigan.  Press  Shift-F2  Design  and  you  can 
design  a  view  query  that  will  filter  your  data. 

That’s  the  concept  behind  the  Control  Center:  data  and  design.  Both  data  and 
design  come  in  two  types.  When  you  view  data  on  the  screen,  you  use  either 
a  Browse  or  Edit  screen.  Browse  shows  many  records  at  once,  while  Edit 
devotes  a  full  screen  to  each  record. 

Many  times  you’ll  find  you  want  to  switch  between  these  two  ways  of  looking 
at  data.  To  do  so,  simply  press  F2  Data.  If  you  are  on  the  Browse  screen,  you 
will  see  your  data  on  an  Edit  screen.  If  you  are  on  an  Edit  screen,  pressing 
F2  Data  takes  you  to  a  Browse  screen. 

Design  also  has  two  basic  types.  You  can  shape  your  data  with  view  queries, 
choosing  the  records  and  fields  you  want  to  display.  You  can  also  modify  the 
way  your  data  is  presented  on  the  screen  or  printer  by  designing  forms, 
reports,  and  labels. 

Creating  a  report  often  requires  alternating  between  designing  the  view 
query  and  the  report.  You  want  the  right  data,  and  you  want  it  to  look  right 
in  the  report.  Flipping  between  these  two  types  of  design  is  easy  with 

Shift-F2  Design. 

Suppose  you’re  designing  a  report  and  decide  you  want  to  limit  the  data  to 
transactions  during  the  last  three  months.  Press  Sh'rft-F2  Design  and  you  can 
modify  the  view  query  to  show  only  the  data  you  want.  To  continue  design¬ 
ing  your  report,  simply  press  Sh‘rft-F2  Design  once  more  and  you  are  back  on 
the  reports  design  surface. 


( 

j 
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Navigating  on  a  Work  Surface 

You  are  connected  to  work  surfaces  by  the  cursor.  Sometimes  the  cursor  is 
simply  a  small  rectangle,  one  character  wide.  At  other  times,  the  cursor 
marks  a  larger  area  of  the  screen.  This  wider  cursor  is  sometimes  called  the 

highlight. 

You  can  move  the  cursor  with  the  cursor  keys.  The  cursor  keys  generally 
work  the  same  way  throughout  dBASE  IV.  On  certain  work  surfaces,  how¬ 
ever,  they  provide  additional  functionality. 

For  example,  T  usually  moves  the  cursor  up  to  the  previous  line.  On  the  Edit 
work  surface,  however,  T  moves  the  cursor  to  the  previous  field,  even  if  that 
field  is  on  the  same  line  as  the  cursor’s  original  position. 

If  you  hold  down  Ctrl  and  then  press  cursor  keys,  you  magnify  their  effect. 
For  example,  -*  moves  the  cursor  right  by  a  single  character,  while  Ctrl—* 
moves  the  cursor  right  by  a  whole  word. 
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Cursor  Navigation  Keystrokes 

dBASE  IV  offers  you  many  ways  to  move  the  cursor  on  your  work  surfaces. 
These  keystrokes  are  summarized  in  Thble  1-1. 


Table  1-1  Cursor  navigation  keys 


Key 

Movement  or  action 

Work  surface 

- 

Right  one  position 

- 

Left  one  position 

i 

Down  one  row 

Next  field 

Edit 

T 

Up  one  row 

Previous  field 

Edit 

PgDn 

Display  next  screen 

Browse,  Edit 

Down  one  screen 

Word  wrap,  layout 

PgUp 

Display  previous  screen 

Browse,  Edit 

Up  one  screen 

Word  wrap,  layout 

End 

End  of  field 

Edit 

Last  field  in  record 

Browse 

Last  text/ field  on  line 

Word  wrap,  layout 

Last  column  of  skeleton 

Queries 

Home 

Beginning  of  field 

Edit 

Beginning  of  record 

Browse 

Left  margin 

Layout 

Indent  (or  left  margin) 

Word  wrap 

First  column  of  skeleton 

Queries 

Backspace 

Delete  previous  character 

Tab 

Next  field 

Edit,  Browse 

Next  tab  stop 

Layout 

Next  column 

Queries,  lists 

Insert  tab  character 

Word  wrap 

Shift-Tab 

Previous  field 

Edit,  Browse 

Previous  tab  stop 

Layout 

Move  margin  left  one  tab 

Word  wrap  (with  Enable  auto^ 

(< continued} 
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Table  1  -1  Cursor  navigation  keys  ( continued) 


Key 

Movement  or  action 

Previous  column 

Work  aurfaca^ndent^ 

Queries,  lists 

— 

Next  field 

Browse,  Edit 

Form  new  paragraph 

Word  wrap 

Break  line,  move  to  new  one 

Layout  (if  Insert  is  on) 

Esc 

Leave,  abandoning  changes; 

cancel  extended  selection 

Del 

Delete  currently  selected 
item 

Ins 

Toggle  insert/typeover 
modes 

Ctrl— 

Beginning  of  next  word 
or  field 

Ctrl— 

Beginning  of  previous  word 
or  field 

Ctri-PgDn 

End  of  text 

Word  wrap 

Bottom  of  layout  surface 

Layout 

Current  field  in  last  record 

Browse,  Edit 

CtrtPgUp 

Beginning  of  text 

Word  wrap 

Top  of  layout  surface 

Layout 

Current  field  in  first  record 

Browse,  Edit 

Ctrl -Home 

Move  into  a  memo  field 

Memo  field 

Ctri-End 

Save  work  and  leave 

Move  out  of  memo  field 

Memo  field 

Ctrl— 

Save  work  and  remain 

Design  screens 

Some  of  the  keys  in  the  navigation  key  table  are  explained  in  more  detail 
below. 

Esc 

When  you  press  Esc  on  the  Browse  or  Edit  screens,  any  changes  you  made 
to  the  current  record  will  be  ignored.  The  previous  data  in  the  current 
record  will  return. 

Any  changes  made  to  records  other  than  the  current  record  will  be  stored. 
dBASE  IV  stores  the  changes  to  a  record  as  soon  as  you  move  the  cursor 

away  from  it. 
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You  can  press  Esc  to  leave  a  memo  field  and  abandon  any  changes  you  have 
made  to  the  memo  field.  Esc  also  backs  you  out  of  menus  and  prompt  boxes. 
Any  settings  you  may  have  changed  in  a  menu  will  retain  their  new  values. 
You  can  also  use  Esc  to  exit  from  full-screen  work  surfaces  to  either  the 
Control  Center  or  the  dot  prompt. 

Del 

There  are  two  uses  for  Del.  Pressing  this  key  when  the  cursor  is  on  a  charac¬ 
ter,  field,  or  box  will  delete  only  that  object. 

Del  will  also  delete  selections  defined  by  F6  Extend  Select.  To  delete  such  a 
selection,  place  the  cursor  inside  the  extended  selection  and  press  Del.  The 
data  highlighted  by  the  extended  selection  will  be  deleted  from  the  screen. 

As  a  safety  feature,  an  extended  selection  can  only  be  deleted  when  the  cur¬ 
sor  is  inside  the  extended  selection.  This  feature  lets  you  make  an  extended 
selection  and  then  edit  other  data  without  losing  the  extended  selection. 

Modifying  Data  on  a  Work  Surface 

You  can  change  the  data  on  a  work  surface  by  retyping  it  or  by  deleting  it. 
You  can  also  move  sections  of  information  from  one  part  of  a  work  surface 
to  another.  On  some  work  surfaces,  you  can  even  set  the  colors  of  boxes  or 
text. 

There  are  special  keys  to  help  you  modify  the  data  on  a  work  surface.  For 
example,  Del  deletes  the  highlighted  character,  while  Backspace  deletes  the 
previous  character. 

The  exact  behavior  of  these  editing  keys  is  discussed  in  each  chapter  that 
describes  a  work  surface. 

Function  Keys 

Some  of  the  activities  you  can  do  with  the  menus  or  navigation  keys  can  also 
be  done  with  special  function  keys.  For  example,  once  you  have  searched  for 
a  particular  word  in  a  memo  field,  you  can  locate  the  next  occurrence  of 
that  word  by  pressing  Shift-F4  Find  Next. 
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Table  1-2  summarizes  the  actions  of  dBASE  IV’s  function  keys.  Certain 
unique  function  key  actions  are  described  in  other  chapters. 

Table  1  -2  Function  keys 


Key 

Result 

FI  Help 

F2  Data 

Display  on-screen  Help 

Switch  to  Browse  or  Edit  screen 

F3  Previous 

Move  to  previous  field  or  object  on  queries  design 
screen 

F4  Next 

Move  to  next  field  or  objecig^n  queries  design 
screen 

F5  Field 

Add  field  to  layout  surface  or  view  skeleton 

F6  Extend  Select 

Select  contiguous  data  or  fields 

F7  Move 

Move  selected  data 

F8  Copy 

F9  Zoom 

Copy  selected  data 

Enlarge/shrink  memo  fields,  condition  boxes,  and 
file  skeletons;  show/hide  files  in  DOS  utilities 
directory  tree 

F10  Menus 

Access  menus  for  current  screen 

Shift-FI  Pick 

Display  list  of  items  available  for  current  fill-in 

Shift-F2  Design 

Display  the  design  screens  for  database  files,  que¬ 
ries,  reports,  forms,  labels,  or  applications 

Shift-F3  Find  Previous 

Locate  previous  occurrence  of  search  string 

Shift-F4  Find  Next 

Locate  next  occurrence  of  search  string 

Shift-F5  Find 

Find  specified  search  string 

Shift-F6  Replace 

Shift-F7  Size 

Replace  search  string  by  another  string 

Change  size  of  design  elements 

Shift-F8  Ditto 

Copy  data  from  corresponding  field  of  previous 
record  into  current  field 

Shift-F9  Quick  Report 

Shift-FI  0  Macros 

Print  a  Quick  Report  of  data 

Access  macros  menu 
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Some  of  the  keys  in  the  function  key  table  are  explained  in  more  detail 
below . 

F6  Extend  Select 

After  you  press  F6  Extend  Select,  move  the  cursor  to  indicate  the  data  you 
want  to  select.  Then  press  *-►.  Your  selection  will  be  highlighted  on  the 
screen.  You  can  then  delete,  copy,  or  move  the  selected  data. 

You  can  also  use  F6  Extend  Select  to  make  quick  selections.  For  example,  if 
you  press  this  key  twice  in  the  word  wrap  editing  mode,  you  select  a  word.  If 
you  press  it  three  times,  you  select  a  paragraph. 

You  can  cancel  an  extended  selection  by  pressing  Esc. 

Shift-F2  Design 

Sh'rft-F2  Design  takes  you  to  one  of  two  types  of  design.  You  can  modify  the 
design  of  a  report,  form,  or  label  with  which  you  may  have  been  working. 

You  can  also  modify  the  design  of  the  view  query  that  contains  the  underly¬ 
ing  data  for  the  current  form,  report,  or  label. 

By  pressing  Shift-F2  Design  again,  you  can  switch  from  one  type  of  design  to 
another.  If  you  are  not  working  on  a  form,  report,  or  label,  then  pressing 
Shift-F2  Design  additional  times  will  leave  you  on  the  queries  design  screen. 

Shift-F8  Ditto 

To  enter  data  on  the  Browse/Edit  screen  that  is  identical  from  one  record  to 
another,  you  can  use  Shift-F8  Ditto.  This  automatically  fills  the  field  you  are 
editing  with  data  from  the  corresponding  field  of  the  previous  record. 


The  Menus 

Every  dBASE  IV  work  surface  displays  a  menu  bar.  The  menu  bar  contains 
the  names  of  menus  that  help  you  carry  out  tasks  in  dBASE  IV.  Each  menu, 
in  turn,  contains  options  that  can  be  chosen  to  do  actions.  Some  options 
even  have  submenus  that  offer  further  choices. 

The  menus  for  the  Edit  screen  are  shown  in  the  line  at  the  top  of  the  screen 
that  contains  the  words  Records,  Go  To,  and  Exit.  This  line  is  called  the 
menu  bar.  Each  of  the  words  on  the  menu  bar  is  the  title  for  a  hidden  menu. 

These  menus  are  called  pull-down  menus,  because  you  can  pull  them  down 
to  see  what  they  contain.  When  you  are  done  with  pull-down  menus,  they 
disappear,  leaving  only  their  titles  in  the  menu  bar.  This  feature  keeps  the 
work  surface  available  for  work  while  giving  you  fast  access  to  menus. 
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In  Figure  1-4,  the  Records  menu  is  pulled  down.  Once  you  finish  using  the 
Records  menu,  it  disappears  and  the  screen  looks  like  Figure  1-1  again. 


Figure  1 4  The  Records  menu  on  the  Edit  screen 
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Choosing  a  Menu  Option 

You  choose  menu  options  from  menus  by  using  the  keys  described  in  Table 
1-3.  The  message  line  displays  information  about  the  menu  option  marked  by 
the  cursor. 


Table  1  -3  Selecting  menu  options 


Desired  Action 

Pull  down  a  menu 
Pull  down  a  particular  menu 
Display  a  neighboring  menu 
Choose  a  menu  option 
Activate  a  chosen  option 


Key  to  Press 
F10  Menus 

Alt  and  first  letter  of  menu  name 
-*  or  •*- 
i  or  t 


Choose  and  activate  option  from  current 
menu 

Back  out  of  a  menu  or  list  of  choices 
Accept  certain  fill-in  menus 

Move  between  columns  in  some  lists  of 
choices 

Move  to  bottom  of  menu  or  list  of  choices 
Move  to  top  of  menu  or  list  of  choices 
Display  next  section  of  choices 
Display  previous  section  of  choices 


First  letter  of  option 

Esc 

Ctri-End 

Tab,  Shift-Tab,  ^ 

End 

Home 

PgDn 

PgUp 


Getting  Help 

dBASE  IV  has  a  three-level  Help  system. 

When  you  first  begin  using  dBASE  IV,  you  will  see  information  boxes.  When 
you  make  an  incomplete  or  improper  choice,  you  will  see  an  error  box  on 
the  screen.  If  you  want  more  information,  you  can  use  dBASE  IV’s  on-screen 
Help  boxes. 

These  three  aspects  of  the  dBASE  IV  Help  system  work  together  to  help  you 
learn  and  use  the  product. 
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The  Information  Box 

Information  boxes  guide  you  through  the  system,  somewhat  like  electronic 
training  wheels.  The  first  time  a  work  surface  is  displayed  in  each  session,  an 
information  box  explains  how  to  use  that  work  surface. 


Layout  Dlnenslons  Fields  Uords  Go  To  Print  Exit 


] - ..  .»■! - .»■  •  Z  ■  - 3- *•  1 


lore  inn  Z.01)_  [DEBUG  llMbl 

Ynu  c.in  print  Mailing  l.ibrl::  ueiny  the  layout 
Oditur.  The  l  ibel  you  cre.ite  m.uj  be  ucid  uith  . 
Tilo  th.it  cont.iin--.  the  field:;  need  in  the  liibi.l 
dee i yn .  (Hciyht  and  Uidth  up  tn  7.55  charactere' 

Piece  Fill  MENlli.  nuee  to  the  ill!  l.Uldd-  rn  nu  ai 
eeluct  the  label  else.  Move  to  the  ^QILE  f"-nu 
:.eleet  a  field  and  Modify  the  tei-i|> late.  Precs 
CTHL  END  to  place  the  field  on  the  label.  You  i 
a  1 co  type  text  directly  onto  the  label. 


Add  field: FS  Select: F6  Moue:F7  Copy:F8  Size: Shift-F7 


Figure  1  -5  An  information  box 


Information  boxes  only  appear  when  you  display  a  new  work  surface  and  do 
not  press  a  key  for  several  seconds.  If  you  press  a  key  as  soon  as  you  reach  a 
new  design  screen,  dBASE  IV  will  process  that  key  without  displaying  an 
information  box. 

You  can  quickly  clear  an  information  box  from  the  screen  by  pressing  a  key 
such  as  Home. 

When  you  feel  comfortable  using  dBASE  IV  without  information  boxes,  you 
can  turn  them  off  by  putting  the  statement  INSTRUCT  =  OFF  in  your  Con- 
fig. db  file  or  by  entering  SET  INSTRUCT  OFF  at  the  dot  prompt. 

You  can  also  turn  off  information  boxes  by  choosing  the  Tools  menu’s 
Settings  option.  Then  set  the  Instruct  option  on  the  Options  menu  to  OFF. 

If  you  turn  off  information  boxes  with  INSTRUCT  =  OFF  in  your  Config.db 
file,  the  information  boxes  will  be  turned  off  in  future  dBASE  sessions.  The 
other  ways  of  turning  off  information  boxes^apply  to  the  current  session. 


NOTE 

When  you  turn  off  the  information  boxes,  you  also  disable  the  Control 
Center  prompt  box  that  otherwise  appears  when  you  press  ■*-*■  from  the 
Control  Center  panels.  You’ll  learn  more  about  these  in  Chapter  2. 
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The  Error  Box 

dBASE  IV  displays  an  error  box  whenever  it  detects  an  error  that  will  inter¬ 
fere  with  your  work. 


Figure  1  -6  An  error  box 


As  shown  in  Figure  1-6,  the  available  error  box  options  are  Cancel,  Edit,  and 
Help.  If  you  choose  Cancel,  you  start  over  with  a  blank  command  line.  Edit 
lets  you  modify  the  command  line  that  produced  the  error  box,  and  Help 
displays  a  Help  box. 

You  can  look  up  the  significance  of  the  error  messages  in  Appendix  A  of  Lan¬ 
guage  Reference. 


The  Help  Box 

You  can  use  the  dBASE  IV  Help  box  to  answer  questions  you  might  have  as 
you  use  dBASE  IV.  The  Help  system  is  context-sensitive,  which  means 
dBASE  IV  makes  every  effort  to  give  you  help  for  your  current  situation. 

Many  of  your  questions  can  be  answered  directly  from  the  screen.  You  can 
even  roam  through  the  topics  to  learn  more  about  particular  aspects  of 
dBASE  IV. 
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Reaching  the  Help  System 

There  are  several  ways  to  reach  the  Help  system. 

■  Press  FI  Help. 

■  Type  help  at  the  dot  prompt. 

■  Type  help  at  the  dot  prompt,  followed  immediately  by  the  name  of  a  spe¬ 
cific  command  or  item  of  interest. 

■  Choose  the  Help  button  from  an  error  box. 

What  the  Help  System  Looks  Like 

When  you  ask  for  help  in  dBASE  IV,  a  Help  box  appears  on  the  screen. 


Figure  1  -7  The  Help  box 


The  Help  box  contains  either  text  about  particular  topics,  or  a  Table  of  Con¬ 
tents  that  lets  you  choose  other  available  topics. 

When  the  Help  box  is  displaying  text,  the  title  of  the  Help  box  indicates  the 
current  topic.  The  text  information  screens  are  organized  like  pages  in  a 
book,  so  you  can  browse  through  them  if  you  want.  F3  Previous  shows  the 
previous  page,  while  F4  Next  displays  the  next  page  in  the  sequence  of  Help 
screens. 
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You  can  use  the  buttons  at  the  bottom  of  the  Help  box  to  choose  different 
help  functions.  To  move  to  the  button  you  want,  press  Spacebar,  or 

Backspace.  When  the  highlight  is  on  the  desired  button,  press  — You  may 
also  select  a  button  by  pressing  the  first  letter  of  its  name.  Esc  takes  you  out 
of  the  Help  system,  back  to  where  you  called  Help. 

■  Contents  changes  the  Help  display  to  one  of  the  nested  Tables  of  Con¬ 
tents  for  the  Help  screens.  From  the  Contents  screen,  you  can  reach  a 
broader  level  of  topic  detail  by  pressing  F3  Previous.  You  reach  a  more 
detailed  description  of  topics  by  pressing  F4  Next  or  |  and  |  move 
the  cursor  up  and  down  the  list  of  topics.  PgUp  and  PgDn  move  through 
the  list  of  items  a  box  at  a  time.  Home  and  End  move  to  the  top  and  bot¬ 
tom  of  the  Contents  list. 

■  Related  Topics  lets  you  choose  a  topic  related  to  the  current  one.  The 
topics  are  displayed  to  the  right  of  the  Help  box,  and  when  you  pick  a 
new  topic,  the  Help  box  shows  a  text  information  screen  for  the  new 
topic.  To  select  a  new  topic  from  Related  Topics,  use  the  same  cursor 
keys  as  those  used  by  Contents. 

You  can  also  use  the  Related  Topics  button  to  quickly  display  a  list  of 
editing  keys,  function  keys,  or  other  relevant  navigation  keys.  If  you  are 
working  at  the  dot  prompt,  you  can  display  a  table  of  ASCII  symbols  and 
their  codes. 

■  The  Backup  button  lets  you  return  to  previously  displayed  Help  screens. 
It  skips  over  any  Contents  or  Related  Topics  screens  you  may  have  used 
to  reach  the  current  page  of  help  information. 

■  The  Print  button  prints  the  current  page  of  information.  This  printout  is 
more  useful  than  a  normal  PrtSc  printout  because  it  prints  only  the  Help 
box  contents. 
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Figure  2-1  The  Control  Center 


Menu  Bar 

The  Control  Center  menu  bar  provides  useful  tools  for  managing  your  files 
and  changing  the  way  you  set  up  dBASE  IV.  The  menu  bar  options  are 
described  in  the  “Using  the  Control  Center  Menu  Bar“  section  of  this 
chapter. 


Catalog  Name 

The  catalog  name  tells  you  the  name  of  the  catalog  in  use.  A  catalog  is  a  col¬ 
lection  of  files  you  want  to  handle  as  a  group.  For  example,  you  could  build 
a  catalog  of  files  for  a  certain  department  in  your  company,  or  for  a  particu¬ 
lar  sales  region. 

Unless  you  specify  a  particular  catalog  in  your  Config.db  file,  dBASE  IV  ini¬ 
tiates  the  Control  Center  with  the  catalog  used  at  the  end  of  your  previous 
session.  If  you  have  no  catalogs,  dBASE  IV  creates  one  from  the  files  in  the 
current  directory. 

You  can  change  to  a  different  catalog  or  modify  the  current  catalog  with  the 
Catalog  menu.  To  find  out  more  about  catalogs,  see  Chapter  12,  “Catalogs.” 


Panels 

The  Control  Center  is  a  gateway  to  the  dBASE  IV  design  and  display  screens. 
The  six  panels  in  the  middle  of  the  screen  represent  your  possible  destina¬ 
tions.  The  names  inside  the  panels  show  up  to  200  files  available  at  each 
destination. 

For  example,  the  Forms  panel  shows  the  name  of  every  form  in  the  current 
catalog.  When  you  go  to  the  forms  design  screen,  these  are  the  forms  with 
which  you  may  work. 
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Hie  Information 

TWo  lines  near  the  bottom  of  the  Control  Center  screen  show  the  name  and 
description  of  the  file  marked  by  the  cursor. 

Navigation  Line 

The  navigation  line  shows  which  keys  accomplish  important  dBASE  IV  func¬ 
tions  from  the  Control  Center. 

Message  Line 

Read  the  message  line  for  more  information  about  options  in  the  Control 
Center  menus. 


How  to  Reach  the  Control  Center 

The  Control  Center  is  the  first  screen  you  see  when  entering  the  menu  sys¬ 
tem.  The  Control  Center  provides  a  menu-oriented  approach  to  dBASE  IV 
functions.  Most  of  these  functions  can  also  be  reached  from  the  commandA 
oriented  dot  prompt.  You  can  display  the  Control  Center  in  three  ways: 

■  Put  the  statement  COMMAND=  ASSIST  in  your  Config.db  file.  (This  is 
the  setting  that  is  placed  in  Config.db  when  you  first  install  dBASE  IV.) 

■  Type  assist  from  the  dot  prompt  and  then  press 

■  Press  F2  ASSIST  from  the  dot  prompt. 


Using  the  Control  Center  Work  Surface 

You  can  use  the  Control  Center  work  surface  to  point  to  files  and  use  them 
in  different  ways. 


The  File  Panels 

The  six  file  panels  on  the  Control  Center  contain  different  types  of  files. 

The  Data  panel  contains  the  names  of  database  files,  which  are  the  files  con¬ 
taining  your  actual  data.  You  can  read  more  about  these  files  in  Chapter  6, 
“Designing  Database  Files.” 

The  Queries  panel  shows  the  names  of  view  queries  and  update  queries. 
View  queries  let  you  see  or  work  with  selected  portions  of  your  data,  while 
update  queries  provide  a  fast  way  to  modify  large  amounts  of  data.  You  can 
read  more  about  these  query  files  in  Chapter  7,  “Designing  Views  and 
Queries.” 

The  Forms  panel  contains  the  names  of  screen  forms,  which  let  you  custom¬ 
ize  the  way  data  is  entered  and  displayed  on  the  screen.  You  can  read  more 
about  forms  in  Chapter  8,  “Designing  Forms.” 
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In  the  Reports  panel  are  the  names  of  reports.  These  reports  can  print 
detailed  accounts  of  your  data  as  well  as  form  letters.  You  can  read  more 
about  reports  in  Chapter  9,  “Designing  Reports.” 

The  Labels  panel  contains  the  names  of  your  labels,  which  can  be  used  to 
print  everything  from  mailing  labels  to  ID  badges.  You  can  read  more  about 
labels  in  Chapter  10,  “Designing  Labels.” 

The  Applications  panel  holds  the  names  of  dBASE  IV  programs,  and  appli¬ 
cations  developed  with  the  dBASE  IV  Applications  Generator.  These  applica¬ 
tions  link  together  many  dBASE  IV  files  to  create  complete  systems  of  forms, 
reports,  labels,  queries,  and  database  files.  You  can  read  more  about 
programs  in  Chapter  11,  “Applications.” 


How  to  Select  a  File 

To  select  a  file,  move  the  cursor  with  the  arrow  keys  until  the  cursor  marks 
the  name  of  the  file  with  which  you  want  to  work.  Then  press 

If  Instruct  is  ON,  the  panel  prompt  box  asks  what  you  want  to  do  with  the 
file.  You  can  select  how  you  want  to  use  the  file  by  placing  the  cursor  over 
the  correct  option  and  pressing  ♦-»•,  or  by  pressing  the  first  letter  of  the 
desired  option. 

If  you  ask  to  use  a  form,  report,  or  label  which  usually  works  with  a  different 
database  file  or  view  than  the  current  one,  another  prompt  box  will  appear. 
This  box  asks  whether  you  want  to  use  the  database  file  or  view  associated 
with  this  form,  report,  or  label.  You  can  also  choose  to  override  the  normal 
source  of  data  and  ask  to  use  the  current  database  file  or  view. 

If  the  new  database  file  or  view  has  a  different  file  structure  than  the  nor¬ 
mally  associated  database  file  or  view,  you  may  get  an  error  message  that 
lists  the  fields  from  the  original  design  that  cannot  be  found  in  the  new  data¬ 
base  file  or  view.  This  happens  because  dBASE  IV  cannot  find  the  fields  it 
needs  to  create  the  form,  report,  or  label. 

You  can  also  change  the  database  file  or  view  associated  with  a  form,  report, 
or  label.  You  do  this  by  first  using  the  desired  database  file  or  view.  Then  go 
to  the  design  screen  for  the  form,  report,  or  label  and  save  the  design.  This 
will  reassign  the  form,  report,  or  label  to  the  current  database  file  or  view. 

Shortcuts  for  Selecting  Files 

You  can  bypass  the  panel  prompt  box  by  placing  the  cursor  on  the  name  of  a 
file  and  pressing  one  of  three  special  function  keys: 

F2  Data  uses  the  Browse  or  Edit  screen  to  display  the  data  in  a  database  file 
or  view. 

If  you  press  F2  Data  when  the  cursor  is  in  the  Data  or  Queries  panels,  you 
see  the  data  for  the  selected  database  file  or  query.  If  you  press  F2  Data 
when  an  update  query  is  highlighted,  you  see  the  data  for  the  target  file  of 
that  update  query.  The  data  appears  on  a  Browse  or  Edit  screen,  whichever 
type  of  screen  you  last  used  for  displaying  data. 
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When  you  press  F2  Data  and  the  cursor  is  on  the  name  of  a  file  in  the  Forms 
panel,  you  see  the  data  for  the  database  file  or  query  associated  with  that 
form.  With  forms,  data  always  displays  first  in  the  format  of  that  form.  If  you 
want  to  have  the  data  displayed  on  a  Browse  screen,  simply  press  F2  Data 
again. 

Pressing  F2  Data  when  the  current  selection  is  a  file  in  the  Applications 
panel  will  cause  a  beep,  since  programs  do  not  have  database  files  associated 
with  them  like  forms,  reports,  and  labels. 

Shift-F2  Design  presents  the  design  screen  for  the  selected  file.  The  options 
on  the  screen  allow  you  to  easily  change  the  design  of  a  database  file,  query, 
form,  report,  or  label.  You  can  also  use  Shift-F2  Design  to  modify  the  code  in 
an  application  file. 

Shift-F9  Quick  Report  prints  a  Quick  Report  of  the  data  in  a  database  file  or 
view.  If  you  press  Shift-F9  Quick  Report  when  the  cursor  highlights  a  form, 
report,  or  label,  dBASE  IV  displays  a  Print  menu  that  lets  you  print  a  Quick 
Report  of  the  data  supporting  the  form,  report,  or  label. 


Turning  Off  the  Panel  Prompt  Box 


You  can  disable  the  panel  prompt  box  by  putting  the  statement 
INSTRUCT  =  OFF  in  your  Config.db  file,  by  entering  SET  INSTRUCT  OFF  at 
the  dot  prompt,  or  by  changing  the  Instruct  option  on  the  Options  menu. 
You  reach  the  Options  menu  by  choosing  the  Settings  option  from  the  Tools 
menu. 

When  the  panel  prompt  box  is  disabled,  pressing  •«-»■  on  the  name  of  a  file 
will  automatically  carry  out  the  option  that  would  have  appeared  first  in  the 
panel  prompt  box. 

Table  2-3  summarizes  the  results  of  pressing  ♦+,  F2  Data,  or  Shift-F2  Design 
on  filenames  in  the  Control  Center.  The  Enter  column  is  used  when  Instruct 
is  OFF.  When  Instruct  in  ON,  the  panel  prompt  box  appears,  and  you  must 
press  <*-»■  twice  to  carry  out  the  operations  in  the  Enter  column.  Pressing 
Shift-F9  Quick  Report  always  prints  either  a  Quick  Report  of  the  data  in  a 
database  file  or  view,  or  a  Quick  Report  of  the  data  in  the  database  file  or 
view  that  supports  a  form,  report,  or  label. 
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Table  2-1  Control  Center  actions  for  different  file  types 


Panel  type 

— 

Shift-  F2  Design 

F2  Data 

Files 

Use  (or  close)  this 
database  file  as  the 
data  source 

Modify  the  structure 
or  record  order  of  this 
database  file 

Browse/Edit 
this  database 
file 

View  queries 

Use  (or  close)  this 
view  as  the  data 

source 

Modify  the  definition 
of  this  query 

Browse/Edit 
this  view 

Update 

queries 

Do  this  update 

Modify  the  definition 
of  this  update  query 

Browse/Edit 
the  target 
database  file 

Forms 

Edit  the  underlying 
database  file  or 
view  using  this 
form 

Modify  the  layout  of 
this  form 

Edit  the 
underly  data¬ 
base  file  or 
view  using 
this  form 

Reports 

Print  this  report 

Modify  the  layout  of 
this  report 

Browse/Edit 
the  data  in 
the  underly¬ 
ing  database 
file  or  view 

Labels 

Print  this  label 

Modify  the  layout  of 
this  label 

Browse/Edit 
the  data  in 
the  underly¬ 
ing  database 
file  or  view 

Applications 

(prg) 

Run  this 
application 

Edit  the  code  for  this 
application 

(inactive) 

Applications 

(.app) 

Run  this 
application 

Modify  the  design  of 
this  Applications 
Generator  application 

(inactive) 

Applications 

(.prs) 

Run  this 
application 

Modify  the  design  of 
this  SQL  application 

(inactive) 

Applications 
(.exe,  .com) 

Run  this 
application 

(inactive) 

(inactive) 
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Displaying  the  Relations  among  Files 

Form,  report,  and  label  files  contain  designs  for  forms,  reports,  and  labels. 
They  do  not  contain  data,  which  is  available  only  in  database  files  or  views. 

Every  form,  report,  and  label  created  from  the  Control  Center  normally 
points  to  a  database  file  or  view  for  its  data.  This  makes  it  easier  for  you  to 
keep  track  of  which  database  file  is  needed  for  which  report,  form,  or  label. 
Once  you  create  forms,  reports,  or  labels  in  the  Control  Center,  they  auto¬ 
matically  point  to  appropriate  underlying  data. 

All  files  related  to  the  one  you  are  using  as  the  source  of  data  are  brought  to 
the  top  of  their  panels,  separated  from  the  rest  of  the  files  by  a  line. 

You  may  use  a  form,  report,  or  label  with  the  current  database  file  or  view, 
even  if  that  file  or  view  is  different  from  the  one  associated  with  the  form, 
report,  or  label.  The  file  or  view  associated  with  a  form,  report,  or  label  is 
only  a  suggestion  for  underlying  data. 

If  you  remove  the  underlying  database  file  or  view  from  the  Data  or  Queries 
pane],  dBASE  IV  will  use  the  current  database  file  or  view.  If  there  is  no  cur¬ 
rent  database  file  or  view,  you  will  be  asked  to  name  one. 


Creating  New  Files 


The  Control  Center  makes  it  easy  to  create  a  new  file.  Simply  position  the 
highlight  in  the  panel  for  the  type  of  file  you  want  to  create.  Then  place  the 
highlight  over  the  <  create >  marker  and  press  The  correct  design 
screen  for  this  type  of  file  will  appear. 


If  you  are  creating  a  form,  report,  or  label,  the  new  file  will  point  to  the 
most  recently  used  source  of  data,  called  the  current  database  file  or  view.  If 
you  want  to  point  to  a  different  database  file  or  view,  choose  the  Use  differ¬ 
ent  database  file  or  view  option  from  the  Layout  menu  when  you  get  to  the 
design  screen. 

If  you  choose  the  <  create  >  marker  from  the  Applications  panel,  you  can 
choose  between  writing  a  dBASE  IV  program  or  working  with  the  dBASE  IV 
Applications  Generator.  If  you  choose  to  write  a  dBASE  program ,  you  will  be 
able  to  write  a  program  in  dBASE  IV’s  program  editor.  If  you  have  chosen  a 
different  editor  with  the  TEDIT  statement  in  your  Config.db,  your  specified 
editor  will  appear  when  you  choose  to  write  a  dBASE  IV  program . 


NOTE 

If  you  want  to  create  an  SOL  program,  you  can  use  the  program  edi¬ 
tor.  Just  make  sure  you  give  the  file  a  .prs  extension  when  you  save  it. 


The  program  editor  is  described  in  Chapter  4,  “Editing,”  in  this  manual.  The 
Applications  Generator  is  described  in  Using  the  dBASE  IV  Applications 
Generator. 

You  may  also  create  or  modify  applications  from  the  dot  prompt.  To  write  a 
dBASE  IV  program,  enter  MODIFY  COMMAND  at  the  dot  prompt.  To  work 
with  the  Applications  Generator,  enter  CREATE  APPLICATION. 


II 
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Deleting  Files 

To  delete  a  file  from  the  Control  Center,  position  the  highlight  over  the  name 
of  the  file  you  want  to  delete,  then  press  Del.  A  prompt  asks  if  you  really 
want  to  delete  this  file  from  the  catalog.  If  you  do,  continue  the  procedure. 
You  will  then  be  asked  if  you  want  to  delete  the  file  from  the  disk  as  well  as 
the  catalog. 

Remember  that  deleting  the  file  from  the  catalog  will  simply  remove  it  from 
this  group  of  files.  The  file  still  exists  and  can  be  added  to  a  different  catalog, 
or  returned  to  the  current  catalog.  Deleting  a  file  erases  it  and  you  cannot 
get  it  back. 


Using  the  Control  Center  Menu  Bar 

The  Control  Center  menu  bar  contains  three  menus:  Catalog,  Tools,  and 
Exit.  These  menus  contain  options  to  help  you  create  and  modify  catalogs. 
You  can  also  manage  your  files  and  adjust  the  way  dBASE  IV  appears  on 
your  screen. 

The  Catalog  menu  is  described  in  Chapter  12,  “Catalogs.”  The  Tools  menu  is 
described  in  Chapter  13,  “Tools.” 

The  Control  Center  Exit  menu  has  two  options:  Exit  to  dot  prompt  and 
Quit  to  DOS.  The  first  option  takes  you  from  the  Control  Center  to  the  dot 
prompt,  where  you  can  enter  commands  directly.  You  can  always  return  to 
the  Control  Center  by  typing  assist,  followed  by  *-*.  You  can  also  press 

F2  Assist. 

The  Quit  to  DOS  option  takes  you  out  of  dBASE  IV  entirely,  back  to  DOS. 

To  return  to  dBASE  IV,  type  dbase  and  press  •*-». 
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Browse 
and  Edit 


Introduction  to  the  Browse  and  Edit  Screens 


This  chapter  describes  two  related  screens,  the  Browse  screen  and  the  Edit 
screen.  Both  screens  let  you  display,  enter,  and  edit  data,  and  they  share  a 
similar  menu  bar.  They  look  different,  however,  and  are  often  used  in  differ¬ 
ent  ways. 

The  Browse  screen  lets  you  display  a  large  number  of  records  at  one  time. 
Many  people  therefore  use  the  Browse  screen  to  locate  a  record  quickly. 

The  Edit  screen  displays  one  record  at  a  time,  showing  you  more  informa¬ 
tion  about  each  record.  You  can  also  customize  Edit  screens  to  suit  your 
particular  needs. 

The  Browse  and  Edit  screens  contain  significant  improvements  over  the  way 
they  worked  in  dBASE  III  PLUS.  You  have  more  control  over  data  when  it’s 
entered  or  displayed.  Memo  fields  can  be  edited  from  the  Browse  screen,  as 
well  as  the  Edit  screen.  You  can  switch  easily  between  Browse  and  Edit 
screens  for  the  same  data.  The  formatting  and  data  checking  features  of  the 
Edit  screen  are  now  also  applied  to  the  Browse  screen. 


Reaching  Browse/Edit  Screens  from  the  Control  Center 


You  can  use  the  Browse  and  Edit  screens  to  display  data  from  the  files  or 
queries  shown  in  the  Data  and  Queries  panels.  You  can  also  browse  the 
underlying  data  for  forms,  reports,  and  labels.  Since  applications  don’t  point 
to  data,  you  cannot  browse  or  edit  application  files. 

To  reach  the  Browse  or  Edit  screen  from  the  Control  Center,  move  the  cur¬ 
sor  to  the  name  of  a  file  in  one  of  the  first  five  Control  Center  panels  and 
press  F2  Data.  This  will  take  you  directly  to  either  the  Browse  or  Edit  screen, 
whichever  you  used  last.  You  can  then  toggle  between  the  Edit  and  Browse 
screens  by  pressing  F2  Data  once  again.  (If  you  place  the  cursor  on  the  name 
of  a  form,  you  see  the  Edit  screen  first.) 

You  cannot  reach  the  Browse  or  Edit  screen  from  the  Applications  panel, 
and  dBASE  IV  will  beep  if  you  press  F2  Data  while  the  cursor  is  on  the  name 
of  an  application. 
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If  the  Instruct  setting  is  ON  (the  default),  you  can  also  reach  the  Browse  or 
Edit  screen  by  moving  the  cursor  to  the  name  of  a  database  file,  query,  form, 
report,  or  label  and  then  pressing  Choose  Display  data  from  the  prompt 
box  on  your  screen.  You  can  then  toggle  between  the  Browse  and  Edit 
screens  by  pressing  F2  Data. 


Reaching  Browse/Edit  Screens  from  Design  Screens 

When  you  are  working  on  the  design  screens  for  queries,  forms,  reports,  or 
labels,  you  may  want  to  examine  the  underlying  data.  You  can  do  this  by 
pressing  F2  Data.  You  will  then  see  either  the  Browse  or  Edit  screen, 
depending  on  which  one  you  used  last.  You  can  toggle  between  the  Browse 
and  Edit  screens  by  pressing  F2  Data. 

If  you  start  from  the  forms  design  screen,  the  Edit  screen  for  this  form  will 
always  display.  You  can  switch  to  the  Browse  screen  by  pressing  F2  Data. 


Reaching  Browse/Edit  Screens  from  the  Dot  Prompt 

Type  browse  or  edit  on  the  command  line.  If  a  database  file  or  view  is  in  use, 
you  will  see  a  Browse  or  Edit  screen  of  that  file.  If  no  database  file  or  view 
has  been  put  into  use,  dBASE  IV  will  ask  you  to  enter  the  name  of  a  database 
file  or  view. 

The  BROWSE  and  EDIT  commands  have  been  given  great  flexibility  in 
dBASE  IV.  You  can  read  more  about  the  options  available  from  the  dot 
prompt  in  Language  Reference. 


Insert 

Browse  and  Edit  make  use  of  Ins,  which  turns  the  Insert  feature  of  dBASE  IV 
on  and  off.  When  Insert  is  off,  newly  typed  characters  replace  the  characters 
at  the  current  cursor  position.  When  Insert  is  on,  new  characters  are 
inserted  at  the  current  cursor  position  between  existing  characters. 

When  Insert  is  on,  Ins  appears  in  the  status  bar.  You  can  toggle  Insert  on 
and  off  by  pressing  Ins. 


Memo  Fields 

When  you  work  on  the  Browse  or  Edit  work  surface,  you  can  take  advantage 
of  a  special  object:  the  memo  field.  You  can  use  a  memo  marker  on  the  Edit 
screen  to  save  display  space.  Memo  fields  also  save  storage  space  by  letting 
you  keep  up  to  64K  of  text  information  for  one  record,  while  not  taking  up 
space  for  records  that  don’t  need  it. 
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Figure  3-1  Memo  fields  on  the  Edit  work  surface 


Memo  fields  can  be  indicated  by  markers.  The  marker  for  a  memo  field  con¬ 
taining  data  is  the  word  MEMO  in  capital  letters.  If  a  memo  field  is  empty, 
the  marker  displays  in  lower  case  as  memo.  This  saves  you  the  trouble  of 
opening  empty  memo  fields,  only  to  discover  they  are  empty. 

Memo  fields  can  also  appear  as  open  boxes  on  the  Edit  screen.  These  boxes 
show  the  information  inside  a  memo  field  and  are  called  memo  windows. 

On  the  Browse  screen,  all  memo  fields  must  first  appear  as  markers.  On  the 
Edit  screen,  memo  fields  can  initially  appear  as  either  markers  or  windows. 
You  can  choose  how  you  want  each  memo  field  to  appear  on  the  Edit  screen 
when  you  design  customized  forms. 

Memo  fields  that  appear  initially  as  memo  windows  are  called  static  memo 
windows,  since  they  cannot  be  changed  into  memo  markers.  Markers  are 
most  useful  when  you  want  to  save  space  on  a  form.  Static  memo  windows 
are  convenient  when  you  want  information  in  memo  fields  to  be  visible 
immediately. 
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Entering  and  Leaving  Memo  Fields 

To  edit  the  text  inside  a  memo  field,  you  must  first  place  the  cursor  inside  it. 

There  are  three  ways  to  open  memo  fields,  each  of  which  works  for  both 

memo  markers  and  memo  windows: 

■  Place  the  cursor  on  the  memo  field  you  want  to  edit.  Press  Ctrl-Home.  If 
the  field  is  shown  as  a  marker,  it  will  open  into  its  memo  window.  You 
can  enter  new  text  or  edit  existing  text  in  the  memo  window. 

■  Place  the  cursor  on  a  memo  field.  Press  F9  Zoom  and  the  memo  field 
will  zoom  open  to  fill  the  screen. 

■  Move  to  the  memo  field  with  the  F3  Previous  or  F4  Next  keys.  When  one 
of  these  keys  places  the  cursor  on  a  memo  field,  it  automatically  opens 
into  its  window . 

Once  inside  a  memo  field,  you  use  the  dBASE  IV  editor  described  in  Chapter 

4,  “Editing.” 

You  have  several  ways  to  leave  a  memo  field: 

■  Press  Ctri-End.  The  memo  window  will  close  down  to  a  marker  or  static 
memo  window,  and  the  cursor  will  remain  on  the  marker  or  border  of 
the  static  memo  window. 

■  Press  F3  Previous  or  F4  Next.  The  memo  window  will  close  down  to  a 
marker  or  static  memo  window,  and  the  cursor  will  move  to  either  the 
previous  or  next  field.  This  saves  you  the  trouble  of  pressing  Ctri-End 
when  leaving  the  memo  field. 

■  Press  Esc.  The  memo  window  will  close  down  to  a  marker  or  static 
memo  window,  and  the  cursor  will  remain  on  the  marker  or  border  of 
the  static  memo  window.  All  your  changes  will  be  abandoned  and 
replaced  by  the  data  previously  in  the  memo  field. 

■  Choose  one  of  the  options  from  the  Exit  menu  of  the  editor. 


A  Special  Note  About  Editing  Views 

Only  views  made  from  a  single  file  skeleton  can  be  edited  on  the  Browse  and 
Edit  screens.  Views  made  from  more  than  one  file  skeleton  can  be  displayed 
and  searched  on  the  Browse  and  Edit  screens,  but  not  edited. 

This  restriction  also  applies  to  views  made  from  duplicate  skeletons  of  the 
same  database  file.  Views  have  several  additonal  conditions  that  may  prevent 
them  from  being  edited.  These  are  discussed  in  detail  in  Chapter  7, 
“Designing  Views  and  Queries.” 
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Using  the  Browse  Work  Surface 

The  Browse  work  surface  consists  of  a  table  of  data.  Each  row  represents  a 
separate  record,  and  each  column  a  different  field. 


Figure  3-2  The  Browse  work  surface 


The  Browse  screen  lets  you  display  many  records  at  one  time.  You  can  use 
this  display  to  examine,  edit,  add,  or  delete  data.  You  can  also  use  it  to  move 
quickly  through  your  records. 

To  edit  data  on  the  Browse  work  surface,  place  the  cursor  in  the  field  you 
want  to  change  and  enter  new  data  or  edit  existing  data. 


Special  Keystrokes  on  the  Browse  Work  Surface 

The  Browse  work  surface  has  special  navigation  keystrokes.  These  are  sum¬ 
marized  in  Table  3-1.  (See  the  “Cursor  Navigation  Keystrokes”  section  of 
Chapter  1  for  a  description  of  the  standard  navigation  keys.) 

The  table  shows  thatffi  (ft  flTOME)andGENij)have  slightly  different  actions  on 
the  Browse  and  Edit  work  surfaces. 
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Table  3-1  Special  keystrokes  on  the  Browse/Edit  work  surface 


Key 

Result 

F4  Next 

Move  to  next  field  (will  open  a  memo  field) 

F3  Previous 

Move  to  previous  field  (will  open  a  memo  field) 

Shift-F8  Ditto 

Copy  data  from  corresponding  field  of  previous  record 
into  current  field 

T 

i 

PgUp 

PgDn 

Home 

Move  up  one  row/Move  to  previous  field 

Move  down  one  row/Move  to  next  field 

Display  previous  screen 

Display  next  screen 

Move  to  first  field  of  current  record/Move  to  beginning 
of  current  field 

End 

Move  to  last  field  of  current  record/Move  to  end  of  cur¬ 
rent  field 

Tab 

Move  to  next  field 

Shift-Tab 

Move  to  previous  field 

Move  to  next  field 

Esc 

Leave  Browse  screen  without  saving  changes  to  current 
record 

Ctrl  — 

Move  to  beginning  of  next  word 

Ctrl— 

Move  to  beginning  of  previous  word 

Ctrl  PgUp 

Ctrl-PgDn 

Ctrl-Home 

Move  to  same  field  in  first  record 

Move  to  same  field  in  last  record 

Move  into  a  memo  field 

Ctrl  End 

Move  out  of  memo  field  or  leave  Browse  screen 

Ctrl-T 

Delete  from  cursor  position  to  end  of  current  word 

Ctrl-Y 

Delete  from  cursor  position  to  end  of  current  line 
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Ctrl  End 

This  key  combination  has  two  slightly  different  functions  in  Browse.  Both 

tell  dBASE  IV  you  have  finished  doing  something. 

■  You  can  use  Ctrl-End  to  finish  working  with  the  Browse  screen,  save  your 
changes,  and  return  to  the  Control  Center  or  dot  prompt.  If  you  have  any 
unsaved  changes  to  the  design  of  queries,  forms,  reports,  or  labels,  the 
relevant  design  screen  will  appear,  and  you  can  choose  to  save  your 
modified  design  before  returning  to  the  Control  Center  or  the  dot 
prompt. 

■  When  the  cursor  is  inside  a  memo  field,  pressing  Ctrl-End  closes  the 
memo  field  and  places  the  cursor  on  the  memo  field.  You  will  still  be  on 
the  Browse  screen. 


The  Edit  Screen 

The  Edit  screen  Jets  you  devote  the  screen  to  a  single  record,  so  you  can  dis¬ 
play  more  information  about  one  record  than  is  possible  with  a  Browse 
screen. 

Many  people  use  the  Edit  screen  to  find  or  enter  data  about  particular 
records,  since  you  can  see  more  information  about  each  record  than  on  a 
Browse  screen. 

You  can  also  customize  the  Edit  screen  to  serve  your  special  needs.  You 
could,  for  example,  add  boxes,  lines,  or  other  graphics  characters  to  make 
the  screen  more  attractive  and  easier  to  use.  You  could  also  include  special 
messages  for  certain  fields  and  control  what  data  can  be  entered  into  partic¬ 
ular  fields. 


Figure  3-3  The  Edit  work  surface 
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Figure  3-3  shows  some  of  the  features  available  on  the  Edit  work  surface. 

The  simple  default  Edit  layout  provided  by  dBASE  IV  puts  every  field  on  a 
separate  line. 

You  can  design  special  forms  for  controlling  how  data  is  entered  or  retrieved 
from  your  database  files  or  views.  You  can  place  fields  on  the  screen  so  they 
are  easier  to  see  or  edit.  You  can  also  exclude  certain  sensitive  or  irrelevant 
fields  from  forms. 

You  can  even  create  dBASE  IV  forms  that  match  forms  you  already  use  in 
your  organization.  The  forms  design  screen  lets  you  design  different  forms  to 
enter  information  into  the  same  database  file.  For  further  information  about 
creating  customized  forms,  see  Chapter  8,  “Designing  Forms.” 


Special  Edit  Objects 

The  forms  you  create  for  the  Edit  screen  can  include  some  special  elements 
that  make  them  easier  to  use.  These  elements  include: 

■  Text  to  guide  you  through  the  form 

■  Lines  to  differentiate  sections  of  the  screen 

■  Boxes  to  enclose  related  material 

■  Memo  windows  to  present  information  from  memo  fields 


Special  Keystrokes  on  the  Edit  Work  Surface 

The  Edit  work  surface  has  special  navigation  keystrokes.  These  are  summa¬ 
rized  in  Table  3-1.  (See  the  “Cursor  Navigation  Keystrokes”  section  of  Chap¬ 
ter  1  for  a  description  of  the  standard  navigation  keys.) 

The  action  of(j),@i  (SOME),  and  (&ND^are  shown  after  the  action  of  these  keys 
on  the  Brows  work  surface 

A 

As  in  Browse,  Ctri-End  has  two  slightly  different  functions  in  Edit.  Both  tell 
dBASE  IV  you  have  finished  doing  something. 

■  You  can  use  Ctri-End  to  finish  working  with  the  Edit  screen  and  return  to 
the  screen  you  came  from.  All  changes  to  your  data  will  be  saved,  and 
you  will  return  to  either  the  Control  Center,  the  dot  prompt,  or  a  design 
screen. 

■  When  the  cursor  is  inside  a  memo  field,  pressing  Ctri-End  closes  the 
memo  field  and  places  the  cursor  on  the  memo  marker  or  memo  win¬ 
dow  border.  You  will  still  be  on  the  Edit  screen. 
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I  -4^g^ffl^ailJsina  the  Browse/Edit  Menu  Bar 

The  Browse  and  Edit  screens  share  a  similar  menu  bar.  The  Edit  menu  bar 
does  not  include  the  Fields  menu. 

Since  these  two  menu  bars  are  so  similar,  they  are  described  together  in  this 
section  as  the  Browse/Edit  menu  bar.  First  the  purpose  of  the  menu  is  pro¬ 
vided,  followed  by  an  explanation  of  each  menu  option. 

The  Browse/Edit  menu  bar  contains  four  menus:  Records,  Fields,  Go  To, 
and  Exit.  These  menus  help  you  do  the  following  operations  on  the  records 
in  a  database  file: 

■  Delete 

■  Blank 

■  Add 

■  Find 

The  Records  Menu 

You  can  use  the  Records  menu  to 
make  changes  to  an  entire  record. 
You  can  delete  or  blank  the  record, 
undo  changes  to  it,  or  lock  the 
record. 


-Vc 


Undo  Change  to  Record 

Use  this  option  to  undo  changes  to  the  current  record.  Once  you  move  the 
cursor  off  a  record,  however,  any  changes  made  to  that  record  are  saved, 
and  cannot  be  undone  with  this  option.  This  option  is  dimmed  when  not 
available. 

Changes  to  a  record  are  also  saved  whenever  you  leave  the  screen  to  flip 
between  Browse  and  Edit  or  to  transfer  to  a  design  screen.  Because  changes 
to  memo  fields  are  saved  whenever  you  leave  the  memo  field,  this  option 
will  not  undo  them  . 


Add  New  Records 

Use  this  option  to  add  new  records  to  the  bottom  of  the  current  database  file 
or  view.  If  the  current  view  was  made  from  more  than  one  file  skeleton,  you 
will  not  be  able  to  add  new  records. 

Mark  Record  for  Deletion/Clear  Deletion  Mark 

This  menu  option  marks  the  current  record  for  deletion.  Records  are  not 
actually  deleted  from  a  database  file  until  you  choose  the  Erase  marked 
records  option  from  the  database  design  screen’s  Organize  menu. 


USING  THE  MENU  SYSTEM 


3-9 


JOBNAnE:  PAGE:  10  SESS:  G  Tue  llay  17  17:09:50  1988 

@tate/d  i  sk2/a I  1 j  obz/CLS_rnanhat/GRP_manhat/JOB_manusemen/DI V_umchap3 

When  a  record  is  marked  for  deletion,  Del  appears  in  the  status  bar  at  the 
bottom  of  the  screen  on  the  Browse  and  Edit  work  surfaces.  The  menu 
option  for  this  record  changes  to  Clear  deletion  mark. 

You  can  also  do  this  action  by  pressing  Ctri-U  when  on  the  work  surface. 


Dot  prompt  equivalent  command 
DELETE 

Blank  Record 

This  option  lets  you  quickly  erase  the  data  inside  the  current  record  so  you 
can  enter  completely  new  data. 


Marking  a  record  for  deletion  leaves  the  data  in  the  record,  but  indi¬ 
cates  the  record  should  be  deleted.  When  the  record  is  erased,  both 
the  data  and  the  space  taken  by  the  record  are  removed. 

Lock  Record 

If  you  are  sharing  data  with  other  users  on  a  network,  you  may  want  to  be 
sure  no  one  else  is  changing  data  while  you  are  working  with  it.  dBASE  IV 
has  an  automatic  locking  system,  so  that  whenever  you  enter  or  change  data 
in  a  record,  the  current  record  is  locked  as  long  as  the  cursor  is  inside  the 
record. 

There  may  be  times  you  want  to  lock  a  record  without  editing  it.  To  make 
sure  the  data  is  not  changed  while  you  are  looking  at  a  record,  use  the  Lock 
record  option.  An  indicator  appears  on  the  screen  to  show  you  have  locked 
this  record.  As  soon  as  you  mo  /e  the  cursor  from  the  record,  the  record  is 
unlocked. 

If  you  are  working  on  a  network,  you  can  also  lock  a  record  by  pressing 
Ctrl-0  from  the  work  surface.  You  will  see  an  indication  in  the  status  bar  that 
this  record  is  locked.  The  expression  RecLock  displays  to  the  left  of  the 
space  where  the  Del  indicator  appears  when  a  record  is  deleted.  Pressing 
Ctrl-0  again  will  unlock  the  record. 

Follow  Record  to  New  Position 

When  you  edit  a  record,  new  data  in  a  field  that  is  being  used  for  the  master 
index  may  change  the  indexed  location  of  the  record  in  the  database  file  or 
view.  You  can  use  this  option  when  records  are  organized  by  an  active  index. 

When  this  option  is  set  to  YES,  the  changed  record  will  appear  in  its  new 
indexed  position.  Set  this  option  to  NO  if  you  want  to  keep  displaying  the 
records  that  used  to  surround  the  newly  altered  record. 


NOTE 

Blanking  a  record  merely  removes  the  data  inside  it.  The  blank  record 
will  remain  in  the  database  file. 
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The  Fields  Menu  (Browse) 


The  Fields  menu  lets  you  control 
how  fields  are  shown  on  the 
Browse  work  surface. 


Lock  Fields  on  Left 

There  may  be  times  when  a  Browse  work  surface  cannot  fit  all  the  fields  in  a 
record  across  a  single  screen.  If  you  scroll  to  the  right,  the  first  few  fields  go 
off  the  screen  to  the  left.  These  fields  are  often  helpful  for  identifying 
records,  and  you  may  want  to  keep  them  on  the  screen. 

You  can  prevent  them  from  disappearing  by  choosing  the  Lock  fields  on  left 
option.  After  choosing  this  option,  fill  in  the  number  of  fields  you  want  to 
keep  visible  on  the  left  side  of  the  screen.  This  option  is  only  available  on  the 
Browse  work  surface. 


NOTE 

The  use  of  the  word  lock  here  is  different  from  the  way  lock  is  used  in 
the  Lock  record  option. 

The  Lock  fields  on  left  option  keeps  certain  columns  on  the  screen. 
The  Lock  record  option  prevents  data  from  being  edited  by  other 
users. 


Blank  Field 

When  you  are  replacing  existing  data  with  completely  new  data,  it  is  often 
convenient  to  start  with  a  clean  slate.  You  can  do  this  by  choosing  the  Blank 
field  option. 

You  can  also  delete  all  the  text  to  the  right  of  the  cursor  (including  the  char¬ 
acter  under  the  cursor)  by  pressing  Ctrl-Y. 

Freeze  Held 

This  option  lets  you  choose  a  field  that  becomes  the  only  field  that  can  be 
edited.  To  remove  the  freeze  field  restriction,  select  this  option  and  delete 
the  name  of  the  field.  Then  press 

Size  Field 

Sometimes  a  field  is  more  useful  if  it  takes  up  less  room  across  the  screen. 
Use  this  option  to  change  the  width  of  the  current  field.  You  can  also  change 
the  width  of  the  current  field  by  pressing  Shift-F7  Size,  adjusting  the  size 
with  the  left  or  right  arrow  keys,  then  pressing  <*-*. 

When  you  change  the  width  of  a  field  with  this  option,  you  are  modifying  the 
field’s  display  width  on  the  screen.  The  actual  width  of  the  field  in  its  data¬ 
base  file  can  only  be  changed  from  the  database  design  screen. 
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For  example,  if  you  have  a  character  field  that  is  12  characters  wide  in  the 
database  file,  you  will  not  be  able  to  enter  more  than  12  characters  in  that 
field,  even  if  you  expand  the  size  of  its  column  on  the  Browse  screen  to  20. 

Most  columns  on  the  Browse  screen  can  be  made  as  narrow  as  the  width  of 
the  field  name  at  the  top  ofeach  column.  You  can  expand  most  colum ns  to 
78  characters.  Only  logical  fields  can  be  more  narrow  than  four  characters, 
if  they  have  a  short  name. 

If  you  make  the  column  for  a  character  field  narrower  than  its  actual  field 
width  in  the  database  file,  the  data  will  scroll  inside  the  display  space  you 

have  set  aside. 

Memo  fields  and  the  field  at  the  extreme  right  of  a  table  cannot  be  sized  on 
the  Browse  screen.  Date  fields  cannot  be  made  narrower  than  eight 
columns. 


The  Go  To  Menu 


With  the  Go  To  menu,  you  can 
quickly  reach  particular  records  in 
a  database  file.  The  design  screens 
for  forms,  reports,  and  labels  also 
contain  their  own  slightly  different 
version  of  the  Go  To  menu. 


This  chapter  describes  in  one  place  the  options  found  on  the  Go  To  menu 
for  the  forms,  reports,  labels,  and  program  design  screens,  as  well  as  the 
Go  To  menu  for  the  Browse  and  Edit  screens.  (The  Go  To  menu  for  the  data¬ 
base  design  screen  is  described  separately  in  Chapter  6,  “Designing 
Databases.”) 

Top  Record  (Browse  and  Edit  screens  only) 

This  option  displays  the  first  record  appearing  in  the  current  database  file.  If 
the  database  file  has  no  current  index,  then  the  first  record  will  be  Record  1. 
If  there  is  a  current  index,  however,  the  first  record  will  be  the  record  that 
occurs  first  according  to  the  current  index. 

Last  Record  (Browse  and  Edit  screens  only) 

This  option  displays  the  last  record  in  the  current  database  file.  This  is  the 
last  record  in  the  order  determined  by  the  current  master  index  or,  if  there 
is  no  active  index,  it’s  the  last  physical  record  in  the  database  file. 

Record  Number  (Browse  and  Edit  screens  only) 

This  option  displays  the  record  with  the  record  number  you  specify.  The  cur¬ 
sor  appears  inside  the  record. 
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Go  to  line  number  (forms,  reports,  labels,  and  program  design 
screens  only) 

This  option  moves  the  cursor  to  the  specified  line  in  the  file. 

Skip  (Browse  and  Edit  screens  only) 

This  option  lets  you  skip  forward  or  backward  a  given  number  of  records. 

The  default  number  of  records  to  skip  is  10.  After  you  choose  this  option, 
you  can  change  the  number  of  records  to  be  skipped  by  changing  the  fill-in 
menu  option.  When  the  correct  number  is  shown,  press  to  carry  out  the 
operation. 

If  you  enter  a  negative  number,  dBASE  IV  will  skip  that  number  of  records 
backward,  toward  the  top  of  the  file. 

Index  Key  Search  (Browse  and  Edit  screens  only) 

This  option  lets  you  search  through  your  data  quickly  by  taking  advantage  of 
your  database  file’s  indexes. 

Suppose  the  data  you  are  seeking  is  part  of  an  index  expression.  First  you 
display  the  database  design  screen  for  the  database  you  want  to  search.  Then 
choose  the  Order  records  by  index  option  from  the  Organize  menu  and 
pick  the  index  you  want  to  be  the  current,  or  master,  index. 

Then  you  can  Browse  or  Edit  the  database  file  and  choose  the  Index  key 
search  option.  When  you  do,  a  prompt  box  displays  the  index  expression  and 
asks  you  to  enter  the  data  you’re  looking  for.  This  description  of  what  you 
are  looking  for  is  called  the  search  string. 

The  Index  key  search  option  has  a  few  simple  rules. 

1.  The  string  must  use  the  exact  style  of  the  index.  If  you  have  an  index  on 
UPPER(lastname)  then  you  must  enter  SMITH and  not  Smith  or  smith  to 
find  a  person  whose  last  name  is  Smith.  This  is  because  all  the  entries  in 
the  index  have  been  converted  to  upper-case  letters  before  making  the 
index.  You  can  tell  how  the  index  is  constructed  by  the  index  expression, 
shown  in  the  prompt  box. 

2.  The  index  key  search  finds  the  first  record  that  contains  the  index 
expression.  The  important  part  of  the  search  string  is  the  beginning, 
since  the  index  key  search  starts  looking  for  a  match  from  the  beginning 
of  the  string. 

In  other  words,  to  find  San  Francisco  in  a  database  file  indexed  on  the 
city  field,  you  could  use  these  search  strings:  San  Francisco ,  San  F,  or 
San.  Of  course,  you  might  find  San  Fernando  or  San  Diego  first.  You 
could  then  enter  a  more  comprehensive  search  string,  or  simply  move 
through  these  neighboring  records  until  you  find  the  one  you  want.  This 
option  only  finds  the  first  matching  record.  But  since  it  uses  the  master 
index,  all  the  other  matching  records  will  be  immediately  after  the  first 
matching  record. 


USING  THE  MENU  SYSTEM 


3-13 


PAGE:  14  SESS:  G 


Tue  flay  17  17:  09:50  1988 
ate/di  sk2/al l j obz/CLS_manhat/GRP_manhat/J0B_manusemen/DIV_umchap3 

3.  The  search  string  does  not  accept  the  wildcards  (*)  and  (?).  These  char¬ 
acters  are  interpreted  literally  as  asterisks  and  question  marks. 

You  can  read  about  the  dot  prompt  equivalents  to  this  option  by  reading  the 
descriptions  of  the  FIND  and  SET  EXACT  commands  in  Language  Reference. 


TIP 

If  you  anticipate  changing  indexes  frequently,  display  your  data  by 
^14  first  entering  the  database  file’s  design  screen,  then  pressing  F2  DATA. 
You  can  then  switch  between  displaying  the  data  and  changing  the 

Jadfixsa, 


Forward  Search 

The  Forward  search  option  offers  you  a  way  to  find  particular  records.  You 
tell  dBASE  IV  which  field  to  look  in  and  what  to  look  for.  dBASE  IV  then 
finds  the  next  record  with  data  matching  the  search  string. 

You  can  use  the  *  and  ?  wildcards  in  the  search  string.  For  example,  to 
locate  123  Maple  Avenue,  possible  search  strings  include  123  Maple  Avenue, 
1?? Maple  *,  or  *Maple*.  A  search  string  of  Maple  would  not  be  complete 
enough  to  find  123  Maple  Avenue. 

You  can  also  use  this  option  on  the  forms,  reports,  and  labels  design  screens. 
On  these  screens,  you  can  find  partial  matches  without  the  wild  ca^. 


■ra  Tip 

^  Although  more  flexible,  this  option  is  not  as  fast  as  Index  key  search. 
If  you  plan  to  search  frequently  on  a  certain  field,  consider  waking  an 
index  for  this  field  so  you  can  take  advantage  of  that  option. 


To  find  a  particular  record  with  the  Forward  search  option: 

1.  Place  the  cursor  in  the  column  of  the  field  you  want  to  use  for  the 
search. 

2.  Choose  the  Forward  search  option. 

3.  A  prompt  box  will  ask  you  for  the  search  string.  Change  the  current  cri¬ 
terion,  if  necessary.  (No  quotes  are  needed,  since  search  criteria  are 
strings,  not  expressions.) 

4.  Press  «-»>. 


NOTE 

If  you  want  to  find  records  based  on  expressions,  such  as  all  the  peo¬ 
ple  whose  income  is  over  $34,000,  see  Chapter  7,  “ Designing  Views.  ” 


3-14 


BROWSE  AND  EDIT 


PAGE:  IS  SESS:  6  Tue  flay  17  17:09:50  1988 
I  sk2/a  I  l  J  obz/CLS_jnanhat  /GRP_manhat/JOB_manusemen/DI  V_umchap3 

After  you  have  found  one  record,  you  can  easily  look  for  the  next  matching 
one.  You  could  select  the  Forward  search  option  again,  but  there  is  a  faster 
way.  Tb  search  for  the  next  matching  record,  press  Shift-F4  Find  Next.  You 
can  continue  pressing  Shift-F4  find  Next  until  you  find  all  the  matching 
records. 

If  you  want  to  return  to  one  of  the  records  already  found,  press 

Shift-F3  Find  Previous. 

Suppose  you  start  your  search  from  somewhere  other  than  the  beginning  of 
the  file.  dBASE  IV  will  automatically  search  to  the  end  of  the  file  and  then 
go  back  to  the  beginning,  until  it  searches  the  entire  database  file. 


Backward  Search 

The  Backward  search  option  works  like  the  Forward  search  option,  except 
it  searches  toward  the  top  of  the  file  instead  of  toward  the  bottom. 

Please  see  the  description  of  Forward  search  for  more  information. 

Replace  (forms,  reports,  labels,  programs  design  screens  only) 

The  Go  To  menu  for  the  forms,  reports,  labels,  and  programs  design  screens 
offers  two  options  not  found  on  the  Go  To  menu  for  the  Browse/Edit 
screens. 

The  first  of  these  options  is  Go  to  line  number,  which  helps  you  reach  a  par¬ 
ticular  row  on  the  layout  surface.  It  works  like  the  Record  number  option 
on  the  Browse/Edit  screen. 

The  other  unique  option  on  the  design  screens  is  Replace.  You  can  use  the 
Replace  option  to  find  a  character,  word,  or  phrase  and  replace  it  with  some 
other  character,  word,  or  phrase. 

This  option  is  often  called  search  and  replace  and  has  been  a  valuable  word 
processing  tool  for  years.  dBASE  IV’s  Replace  option  can  increase  your  pro¬ 
ductivity  when  working  with  memo  fields  or  writing  dBASE  IV  programs. 
This  option  can  also  help  you  modify  forms,  reports,  or  labels. 

When  you  select  this  option,  a  prompt  box  will  appear.  It  asks  for  a  search 
string,  which  is  the  actual  text  (such  as  LNAME)  that  you  want  to  replace. 
After  you  enter  this  text  and  press  «-►,  dBASE  IV  will  look  for  any  occur¬ 
rences  of  the  search  string. 

If  an  occurrence  of  the  search  string  is  found,  a  message  at  the  bottom  of  the 
screen  displays  Replace/Skip/ All/Quit?  (R/S/A/Esc). 

If  you  press  rto  choose  Replace,  the  currently  selected  text,  which  matches 
the  search  string,  is  replaced  by  the  replacement  string.  You  could,  for  exam¬ 
ple,  replace  LNAME  with  LASTNAME. 
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dBASE  IV  then  looks  for  the  next  occurrence  of  the  search  string.  If  it  finds 
one,  the  same  message  will  appear  on  your  screen,  asking  what  you  want  to 
do.  If  you  choose  s,  which  stands  for  Skip,  dBASE  IV  does  not  replace  the 
current  text,  but  goes  on  to  look  for  the  next  occurrence  of  the  search  text. 

You  can  also  choose  a  to  automatically  replace  every  occurrence  of  the 
search  string.  Pressing  Esc  will  abandon  the  search  and  replace  operation, 
keeping  any  changes  made  so  far. 

After  you  complete  a  Replace  operation,  the  message  line  shows  how  many 
times  the  replacement  was  made. 

You  can  also  initiate  a  search  by  pressing  Shift-F6  Replace.  This  function  key 
uses  the  same  procedure  as  the  Replace  option. 

Match  Capitalization 

You  can  use  this  option  to  tell  dBASE  IV  that  a  record  must  have  the  same 
capitalization  as  the  search  criterion  for  a  find  to  be  successful. 

In  other  words,  if  Match  capitalization  is  set  to  YES,  then  a  search  criterion 
of  DeQuincyv/iW  not  accept  dequincy  or  DEQUINCY as  valid  matches. 

If  Match  capitalization  is  set  to  NO,  then  a  search  criterion  of  demille  will 
find  DeMille,  DEMILLE ,  or  Demille. 

On  the  design  screens,  Match  capitalization  also  determines  how  replace¬ 
ments  will  be  handled. 

If  Match  capitalization  is  set  to  YES,  the  replacement  will  retain  its  own 
capitalization.  For  example,  if  the  replacement  string  is  TURKEY \  and  you 
are  searching  for  China ,  the  replacement  will  be  made  as  TURKEY. 

If  Match  capitalization  is  set  to  NO,  the  replacement  string  will  assume  the 
same  capitalization  as  the  text  it  is  replacing.  For  example,  if  the  replace¬ 
ment  string  is  TURKEY,  and  it  is  replacing  China,  the  replacement  will 
appear  as  Turkey. 

Matches  are  formed  as  follows: 

■  If  the  text  is  all  caps,  then  the  replacement  will  be  all  caps. 

■  If  the  text  is  all  lower  case,  then  the  replacement  will  be  all  lower  case. 

■  If  the  text  is  neither  all  caps  nor  all  lower  case,  then  the  replacements 
will  have  the  same  capitalization  as  the  first  letter  of  the  text  it  is 
replacing. 


The  Exit  Menu 


With  the  Exit  menu,  you  can 
quickly  leave  the  Browse  or  Edit 
screen. 
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Exit 

This  option  returns  you  to  the  Control  Center  or  the  dot  prompt,  depending 
on  how  you  reached  Browse  or  Edit. 

If  you  have  modified  the  design  of  a  view,  form,  report,  or  label,  you  will  be 
asked  if  you  want  to  save  this  new  design.  If  you  choose  not  to  save  the  new 
design,  any  unsaved  changes  will  be  abandoned.  Any  changes  you  already 
saved  during  this  design  session,  of  course,  will  be  retained. 

Transfer  to  Query  Design 

This  option  takes  you  to  the  queries  design  screen.  If  you  are  using  a  view, 
that  view  query  appears  on  the  queries  design  screen. 

If  you  are  using  a  database  file,  the  queries  design  surface  automatically 
shows  a  default  view  query.  This  default  view  query  consists  of  every  field  in 
the  database  file,  with  no  conditions  or  calculated  fields.  If  you  modify  this 
view  query,  a  new  view  query  will  be  created  and  saved.  If  you  do  not  mod¬ 
ify  the  view  query,  this  default  view  query  will  not  be  saved. 

Return  to  <  object  >  Design  (forms,  reports,  and  labels  design 
screens  only) 

If  you  got  to  the  Browse  or  Edit  work  surfaces  from  a  design  screen,  use  this 
option  to  return  to  that  design  screen.  This  menu  option  is  context-sensitive 
and  changes  to  match  your  current  situation. 

For  example,  if  you  come  to  the  Browse  screen  from  the  labels  design 
screen,  the  option  appears  as  Return  to  Label  Design  and  you  can  use  it  to 
return  to  the  labels  design  screen. 

If  you  come  to  the  Browse/Edit  screen  from  the  dot  prompt  or  a  program, 
this  option  does  not  appear  on  the  Exit  menu. 
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Editing 


Introduction 


dBASE  IV  provides  two  editing  modes,  word  wrap  and  layout. 

Word  wrap  mode  works  like  a  traditional  word  processor.  You  can  use  it  to 
write  memo  fields,  reports,  and  dBASE  IV  programs.  Word  wrap  mode  treats 
text  as  long  character  strings  that  wrap  inside  the  editor’s  margins.  When 
you  remove  or  add  a  section  of  text,  the  editor  automatically  wraps  and  rear¬ 
ranges  the  rest  of  the  text. 

Layout  mode  helps  you  design  forms,  reports,  and  labels.  In  this  mode,  the 
editor  treats  the  screen  like  a  bulletin  board  on  which  objects  can  be  shuf¬ 
fled  around  or  placed  on  top  of  each  other.  When  you  move  text  to  a  new 
place  on  the  screen,  the  rest  of  the  text  will  not  automatically  wrap  or 
reform  at. 

One  way  to  distinguish  the  two  modes  is  to  think  of  word  wrap  as  a  tool  for 
writing  in  dBASE  IV,  while  layout  mode  is  used  for  drawing. 

Both  the  word  wrap  and  layout  modes  are  used  in  designing  reports.  Each 
must  be  in  a  separate  band  in  the  report.  You  can  read  more  about  report 
bands  in  Chapter  9,  “Designing  Reports.” 

You  will  find  the  word  wrap  and  layout  modes  in  several  places  in 
dBASE  IV.  Labels  and  forms  are  always  in  layout  mode.  Memo  fields,  pro¬ 
grams,  and  text  files  are  always  in  word  wrap  mode.  Reports  are  made  of 
bands  that  can  be  either  word  wrap  or  layout  mode. 


The  Word  Wrap  Work  Surface 


In  word  wrap  mode,  you  can  write  memo  fields  and  programs.  You  can  also 
use  the  word  wrap  mode  in  a  report  band,  if  you  specify  that  band  is  a  word 
wrap  band. 

Design  Elements 

When  you  write  memo  fields  or  programs,  you  work  only  with  text  —  char¬ 
acters  typed  in  from  the  keyboard  or  read  in  from  other  files. 
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When  you  work  in  a  wrapping  band  of  a  report,  you  can  also  place  fields  on 
the  work  surface.  When  you  print  the  report,  these  fields  are  filled  with  data. 
This  lets  you  print  reports  that  combine  fixed  text  with  changing  data. 

Word  wrap  mode  does  not  support  line  or  box  drawing. 

Dimensions  of  Word  Wrap  Mode 


Figure  4-1  The  word  wrap  mode 

Word  wrap  mode  can  have  different  widths,  depending  on  what  you  are 
designing.  Memo  windows  and  the  wrapping  bands  in  reports  can  be  up  to 
255  characters  wide,  while  programs  can  be  up  to  1,024  characters  wide. 

The  text  in  word  wrap  mode  scrolls  up  and  down,  limited  only  by  the  mem¬ 
ory  you  have  available. 

Margins 

Word  wrap  mode  wraps  text  to  fit  inside  its  margins.  These  margins  can 
be  set  in  several  ways,  as  described  in  the  “Modify  Ruler”  and  “Special 
Keystrokes”  sections  of  this  chapter. 

dBASE  IV  word-wrapped  text  is  formatted  paragraph  by  paragraph.  For 
example,  when  you  change  the  margin  of  the  current  paragraph,  all  the  text 
in  that  paragraph  is  reformatted  to  fit  within  the  new  margins.  Format 
changes  do  not  affect  the  paragraphs  before  or  after  the  current  paragraph, 
unless  they  and  the  current  paragraph  are  part  of  an  extended  selection.  In 
that  case,  the  format  changes  are  applied  to  all  the  paragraphs  in  the 
extended  selection. 
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Automatic  Backups 

When  you  write  programs,  dBASE  IV  automatically  creates  a  backup  copy  of 
the  file  you  are  working  on.  This  file  has  the  .bak  extension. 

Using  the  Program  Editor  for  Non-Program  Files 

You  can  use  the  dBASE  IV  editor  to  write  or  modify  text  files  even  if  they  are 
not  dBASE  programs.  From  the  dot  prompt,  type  MODIFY  FILE,  followed  by 
the  name  of  a  file.  dBASE  IV  will  then  let  you  use  word  wrap  mode  to  work 
with  your  non-program  file. 


The  Layout  Work  Surface 

Layout  mode  provides  a  canvas  on  which  you  can  draw  boxes  and  lines  or 
place  fields  and  text.  You  can  move  these  design  elements  easily  around  the 
work  surface  to  design  forms,  labels,  and  reports. 

Design  Elements 

Layout  mode  offers  you  several  design  elements.  You  have  text  and  fields, 
just  like  word  wrap  mode,  along  with  lines  and  boxes. 

Boxes  are  used  to  emphasize  text  and  fields,  and  they  are  manipulated  inde¬ 
pendently  of  text,  fields,  and  lines.  You  can  read  how  to  draw  lines  and  boxes 
in  Chapter  8,  “Designing  Forms.” 

Memo  fields  are  special  types  of  fields,  indicated  with  memo  markers  or 
memo  windows.  You  can  use  them  to  hold  a  lot  of  text  information,  without 
taking  up  a  lot  of  space  on  the  layout  surface. 

When  a  memo  marker  appears  on  a  finished  form,  it  will  be  in  upper  case 
(MEMO)  if  there  is  data  in  the  memo  field.  When  the  memo  field  is  empty, 
the  marker  will  appear  in  lower-case  letters  (memo). 

When  you  open  a  memo  field  on  a  finished  form,  you  can  have  it  fill  the 
screen  by  pressing  F9  Zoom.  You  can  also  open  a  memo  field  into  a  smaller 
memo  window  by  pressing  Ctrl-Home.  The  location  of  a  memo  field’s  window 
is  specified  when  you  design  a  form.  See  the  “Adding  a  Field  to  the  Work 
Surface”  section  of  this  chapter,  as  well  as  the  “Memo  Fields”  section  of 
Chapter  3. 

When  labels  or  reports  contain  memo  fields,  the  field  contents  are  printed 
according  to  the  templates  and  picture  functions  of  the  fields. 


USING  THE  MENU  SYSTEM 


4-3 


IBNAtlE:  PAGE:  4  SESS:  5  Fr  i  May  20  13:03:23  1988 

ate/d  i  sk2/a l l j  obz/CLS_manhat/GRP_rnanhat/J0B_manusemen/DIV_umchap4 

Dimensions 

Layout  mode  can  have  different  widths,  depending  on  what  you  are 
designing. 


Figure  4-2  The  layout  mode 

For  labels,  the  editor  is  as  wide  as  the  label,  up  to  255  characters  across. 
When  you  design  a  form,  the  layout  editor  is  80  columns  wide.  Reports  use 
the  widest  version  of  the  layout  editor,  up  to  255  columns  across. 

When  you  type  past  the  right  margin,  you  hear  a  beep.  If  you  try  to  type  or 
move  the  cursor  past  the  right  edge  of  the  layout  surface,  you  hear  a  beep, 
and  an  error  message  appears. 

The  height  of  the  editor  is  limited  in  one  of  two  ways.  For  labels,  the  editor 
is  only  as  tall  as  the  height  of  the  label,  up  to  255  lines  high.  For  reports  and 
forms,  the  height  is  limited  by  the  memory  you  have  available. 


must  always  be  18  work  surface  spaces  in  each  line. 


NOTE 

Although  layout  surfaces  can  be  up  to  255  characters  wide,  you  are 
only  allowed  237  actual  characters  per  line.  In  other  words,  there 


Margins 

Text  in  layout  mode  does  not  wrap.  This  means  the  left  and  right  margins  are 
used  only  for  aligning  text  or  determining  where  the  cursor  should  go  when 
you  press 

If  you  change  the  margins,  text  already  on  the  work  surface  is  not  affected. 
The  new  margins  apply  only  to  new  text  still  to  be  entered.  You  can,  how¬ 
ever,  move  an  extended  selection  of  existing  fields  and  text  with  F7  Move  or 
the  Position  option  on  the  Words  menu. 
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Spaces  in  Layout  Mode 

To  make  your  layout  surface  as  effective  as  possible,  dBASE  IV  makes  a  dis¬ 
tinction  between  space  available  on  the  work  surface  and  actual  blank  char¬ 
acters  you  may  type  onto  the  work  surface. 


Dear 


XXXXXX  XXXXXXXX, 


T 

User-entered 

blank 


Sincerely, 


XXXXXX  I  XXXXXXXX 


T 

Layout  surfaoe 
shaded  areas 

Figure  4-3  Empty  work  surface  and  blank  characters 

If  nothing  is  typed  onto  the  work  surface,  it  looks  like  the  empty  area  above. 
An  empty  layout  work  surface  shows  as  a  shaded  area.  When  you  press  the 
Spacebar,  blank  characters  replace  the  shaded  area.  As  you  work  with  the 
layout  surface,  you  will  see  how  this  distinction  gives  more  precision  to  your 
design  tasks. 

Boxes  and  Text 

Boxes  are  handled  independently  of  text  and  fields.  You  can,  for  example, 
move  a  box  without  moving  the  text  inside  the  box.  Or  you  can  delete  the 
text  inside  a  box  without  deleting  the  borders  of  the  box.  If  you  want,  you 
can  also  include  a  box  and  its  contents  in  an  extended  selection. 

Text  and  fields  are  placed  on  top  of  boxes.  If  you  put  the  cursor  on  the  bor¬ 
der  of  a  box  and  start  typing,  the  box’s  border  will  be  replaced  by  the  new 
text  you  type.  If  you  enter  a  blank  character  with  the  Spacebar,  the  border 
will  be  replaced  by  the  blank  character. 

Placing  the  cursor  on  a  character  that  covers  part  of  a  box  border  does  not 
select  the  box.  The  box  is  selected  only  if  you  move  the  cursor  to  one  of  the 
border  lines  of  the  box. 

You  can  read  how  to  draw  lines  and  boxes  in  Chapter  8,  “Designing  Forms.” 

How  Fields  Grow  and  Shrink 

On  the  report  design  work  surface,  character  blanks  help  glue  fields 
together.  If  fields  are  assigned  the  horizontal  stretch  attribute,  when  they 
are  printed,  they  grow  or  shrink  to  match  the  data  inside  them. 
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For  example,  suppose  you  design  a  report  with  only  eight  spaces  in  the  tem¬ 
plate  for  the  last  name  field,  and  you  assign  the  horizontal  stretch  attribute 
to  that  field.  When  you  print  the  report,  the  field  shrinks  to  five  spaces  for 
the  name  Jones ,  but  expands  to  12  spaces  for  the  name  Baden-Powell. 


Dear  Joe  Jones, 


Sincerely, 

Sy  Jackson 


Figure  4-4  Using  blank  characters  in  a  report 

If  you  put  a  blank  character  between  the  Lastname  field  and  the  Firstname 
field,  as  shown,  the  blank  character  will  connect  the  two  fields.  If  the  two 
fields  are  separated  only  by  shaded  work  surface  space,  they  will  not  expand 
or  shrink  together. 


Using  Your  Own  Editor 

You  may  use  any  editor  to  write  programs,  text  files,  or  memo  fields.  When 
you  use  an  external  editor,  make  sure  you  save  your  work  in  the  editor  to  an 
ASCII  file. 

You  can  use  two  different  sett  ngs  in  your  Config.db  file  to  tell  dBASE  IV 
that  you  want  to  use  your  own  editor. 

The  TEDIT  setting  lets  you  use  an  external  editor  to  edit  programs  and  files. 
This  setting  also  affects  editing  in  the  window  available  at  the  dot  prompt 
and  SQL  command  lines.  Setting  TEDIT  to  an  outside  editor  also  brings  up 
this  external  editor  when  you  choose  the  Edit  option  from  the  Options 
menu  on  the  DOS  utilities  menu  bar.  This  menu  bar  is  reached  through  the 
Tools  menu 
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The  WP  setting  lets  you  use  an  external  editor  to  edit  memo  fields. 

The  word  wrap  bands  in  reports  are  not  effected  by  either  WP  or  TEDIT. 
They  always  use  the  built-in  word  wrap  rrfode  of  dBASE  IV. 

You  can  find  out  more  about  the  WP  and  TEDIT  settings  in  the  “Customizing 
dBASE  IV”  chapter  in  Language  Reference. 


Using  the  Editor  Work  Surfaces 

The  common  characteristics  of  the  word  wrap  and  layout  modes  are 
described  below. 


Entering  Text 

The  blinking  cursor  shows  where  text  will  be  entered.  You  can  enter  text  in 
two  different  ways.  With  Insert  on,  new  characters  push  existing  characters 
to  the  right.  With  Insert  off,  new  characters  replace  existing  characters. 

You  can  tell  whether  you  have  Insert  on  or  off  by  looking  at  the  cursor. 

When  Insert  is  on,  the  cursor  is  taller.  The  status  bar  also  displays  the  letters 

Ins. 

The  -M-  key  behaves  differently  in  the  word  wrap  and  layout  modes. 

In  word  wrap  mode,  «-►  starts  a  new  paragraph  and  positions  the  cursor  at 
the  beginning  of  this  new  paragraph.  The  new  paragraph  inherits  the  format¬ 
ting  of  the  old  paragraph. 

In  layout  mode,  if  you  have  Insert  off,  moves  the  cursor  to  the  left  margin 
of  the  next  line  without  affecting  any  text. 

If  Insert  is  on,  creates  a  new  blank  line,  pushing  all  text  and  fields  below 
the  current  line  down  one  line.  Text  or  fields  to  the  right  of  the  cursor  are 
placed  in  the  newly  created  blank  line  starting  at  the  left  margin.  The  cursor 
is  also  placed  at  the  left  margin. 

You  can  therefore  create  a  blank  line  in  layout  mode  by  turning  on  Insert 
and  pressing  ^  at  the  beginning  or  end  of  a  line.  You  can  also  create  a 
blank  line  by  pressing  Ctrl-N. 


Memo  Fields 

When  you  use  layout  mode  for  forms,  reports,  or  labels,  you  can  place 
memo  fields  on  the  work  surface.  You  can  also  put  memo  fields  in  a  wrap¬ 
ping  band  when  you  design  a  report. 

You  can  find  out  how  to  open  and  close  memo  fields  in  a  form  by  reading 
Chapter  3,  “Browse  and  Edit.” 

Editing  Memo  Fields 

You  can  enter  information  into  memo  fields  with  either  the  Browse/Edit 
screen  or  the  REPLACE  and  APPEND  MEMO  commands  at  the  dot  prompt. 
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When  you  enter  information  into  memo  fields  from  the  Browse/Edit  screen, 
dBASE  IV  uses  the  word  wrap  mode.  Memo  field  editing  does  not,  however, 
use  all  the  features  of  the  word  wrap  mode.  You  cannot  store  styling  infor¬ 
mation  or  preserve  special  tab  settings  in  memo  fields. 


up 

g  When  writing  in  memo  fields,  it  is  best  to  keep  the  default  tab  settings. 
HUI  That  way,  your  tabs  will  appear  the  same  way  as  when  you  created 
the  text. 


In  addition,  when  you  reload  a  memo  field,  dBASE  IV  re-creates  the  margins 
and  indents  from  what  they  appear  to  be  from  the  text  saved  in  each  para¬ 
graph.  This  has  two  possible  effects: 

■  When  you  reload  a  memo  field,  the  new  right  margin  of  each  paragraph 
extends  only  as  far  right  as  the  longest  line  in  the  paragraph.  If  none  of 
the  lines  in  the  original  paragraph  extended  all  the  way  to  the  original 
right  margin,  the  new  right  margin  will  be  smaller  than  the  original  one. 
The  text  will  appear  the  same,  but  will  wrap  differently  if  any  changes 
are  made. 

■  If  you  have  a  one-line  paragraph,  its  indentation  and  margin  will  both  be 
assigned  to  the  column  in  which  the  first  character  appears. 


The  reason  memo  field  editing  does  not  use  all  the  word  wrap  features  is  so 
that  you  can  use  your  own  text  editor  to  enter  information  into  memo  fields. 
When  you  use  an  external  editor  for  memo  fields,  however,  you  should  use 
the  ASCII  mode  of  the  editor. 

If  you  use  an  external  text  editor  on  memo  fields  but  do  not  use  that  editor’s 
ASCII  mode,  any  special  control  characters  used  by  the  text  editor  will  make 
it  difficult  to  work  with  the  memo  field  in  dBASE  IV. 

To  tell  dBASE  IV you  want  to  use  an  external  editor  for  memo  fields,  use  the 
WP  setting  in  your  Config.db  file. 


NOTE 

Do  not  confuse  the  WP  setting  with  the  TEDIT  setting,  which  is 
described  in  the  “Using  an  External  Editor”  section  of  this  chapter. 
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Placing  Memo  Fields 

When  you  put  memo  fields  in  the  design  of  a  form,  you  indicate  both  where 
the  memo  marker  should  be  displayed  and  the  location  and  size  of  the  memo 
window.  When  you  design  a  report  or  label,  memo  fields  are  shown  as  field 
templates.  How  a  memo  field  expands  when  it  is  printed  depends  on  its  hori¬ 
zontal  and  vertical  stretch  attributes. 

You  can  find  out  how  to  place  and  modify  memo  fields  in  Chapters  8,  9, 
and  10. 


Selecting  Material  from  the  Editor  Work  Surfaces 

You  can  select  certain  items  by  simply  pointing  to  them  with  the  cursor. 
These  items  are  single  text  characters,  fields,  and  boxes. 

You  can  also  select  material  from  the  work  surface  with  F6  Extend  Select. 
After  you  press  F6  Extend  Select,  move  the  cursor  to  extend  the  selection, 
then  press  to  finish  the  selection. 

Once  material  is  selected,  you  can  move,  copy,  or  delete  it.  After  you  have 
made  a  selection,  you  can  place  the  cursor  somewhere  else  without  losing 
the  highlighted  selection.  You  can  also  change  the  width  of  fields  and  the 
height  or  width  of  boxes  and  memo  windows. 

The  word  wrap  and  layout  modes  handle  extended  selections  a  little  differ¬ 
ently.  Extended  selections  in  word  wrap  text  select  all  wrapped  text  between 
one  character  and  some  other  character. 


Pog*  Hnd»r  Band-—-.  -  ■ 

Report  Intro  Band  ■ 

George, 

Here  are  the  latest  figures  for  the  Eastern  Division. 
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Figure  4-6  shows  an  extended  selection  in  layout  mode.  Extended  selections 
on  the  layout  work  surface  define  a  rectangular  block  of  characters. 


Figure  4-6  Extended  selection  in  layout  mode 

Quick  Selections 

You  can  quickly  select  large  amounts  of  material  by  pressing 
F6  Extend  Select  several  times.  This  special  use  of  F6  Extend  Select  is 
shown  in  Table  4-1. 


Table  4-1  Extended  selections 


Mode 

Second  F6 

Third  F6 

Word  wrap 

Word/ field 

Paragraph 

Forms 

Line 

Entire  form 

Reports  layout  band 

Line 

Entire  band 

Labels 

Line 

Entire  label 

On  box  border 

Box  and  border 
characters 

Box,  border  characters, 
and  box  interior 

You  can  undo  an  extended  selection  by  pressing  Esc.  You  can  also  begin  a 
new  extended  selection  by  simply  pressing  F6  Extend  Select. 


Deleting  from  the  Editing  Work  Surfaces 

You  can  delete  two  types  of  selections  from  the  editing  work  surfaces:  items 
touched  by  the  cursor  and  larger  extended  selections. 

In  word  wrap  mode,  characters  act  like  links  in  a  long  chain,  which  wraps 
back  and  forth  across  and  down  the  screen.  When  you  delete  a  character  or 
field,  the  other  characters  and  fields  to  the  right  of  the  deleted  character 
move  to  the  left,  pulling  all  the  characters  up  to  close  the  gap  created  in  the 
chain. 

The  only  exception  to  this  rule  is  when  you  press  Backspace  and  you  have 
Insert  off.  In  this  case,  the  character  to  the  left  of  the  cursor  is  replaced  by  a 
blank  character,  the  cursor  moves  to  this  blank  space,  and  all  the  other  text 
and  fields  remain  as  they  were. 
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If  the  cursor  is  just  past  the  right  edge  of  an  extended  selection,  pressing 
Backspace  moves  the  cursor  into  the  extended  selection,  without  deleting 
anything. 

Layout  mode  handles  deletions  a  little  differently.  Characters  and  fields  on  a 
layout  surface  are  considered  attached  to  each  other  only  when  they  are  con¬ 
tiguous,  with  no  layout  surface  spaces  between  them.  Attached  characters 
and  fields  behave  like  words  in  word  wrap  mode,  filling  in  spaces  created  by 
deletions. 

If  you  have  characters  or  fields  that  are  not  attached  to  the  current  charac¬ 
ters  or  fields,  deletions  do  not  affect  these  neighboring  but  unattached  char¬ 
acters  or  fields. 

word  wrap  mode  and  layout  mode,  if  you  press  Ctrl-T,  you  delete 
ers  from  the  cursor  position  to  the  end  of  the  current  word.  If  you 
tri-Y,  you  delete  from  the  cursor  position  to  the  end  of  the  line. 

NOTE 

When  a  field  is  in  an  extended  selection,  deleting  the  extended  selec¬ 
tion  will  only  delete  that  field  if  its  entire  field  template  is  included  in 
the  selection. 


Moving  and  Copying  Selections 

Once  you  have  made  an  extended  selection,  you  can  move  or  copy  it  to 
another  place  on  the  work  surface  with  F7  Move  or  F8  Copy.  After  making  a 
selection,  place  the  cursor  where  you  want  the  selection  to  appear.  You  can 
move  the  cursor  with  options  on  the  Go  To  menu,  the  arrow  keys,  Tab, 

Shift-Tab,  Home,  End,  PgUp,  and  PgDn. 

When  the  cursor  is  positioned  where  you  want  it,  press  F7  Move  or  F8  Copy. 

If  you  are  on  the  word  wrap  surface,  the  selected  material  is  immediately 
moved  or  copied.  If  you  are  on  the  layout  surface,  a  ghost  the  same  size  as 
the  selection  appears.  This  ghost  of  the  selection  lets  you  make  last-minute 
adjustments  to  the  location  of  the  copy  or  move.  When  you  press  the 
material  is  moved  or  copied  to  the  position  of  the  ghost  of  the  selection. 


In  word  wrap  mode,  when  you  move  or  copy  material,  dBASE  IV  always 
treats  the  material  as  an  insertion.  When  you  are  moving  material,  the  origi¬ 
nal  selection  is  deleted  from  its  location  and  any  text  or  fields  to  the  right 
are  shifted  left. 

In  layout  mode,  material  at  the  destination  of  the  move  or  copy  is  overwrit¬ 
ten.  This  is  because  there  is  no  concept  of  wrapping  in  layout  mode. 

When  you  move  material  on  a  layout  surface,  the  original  selection  location 
is  blanked  rather  than  deleted.  The  selection  is  removed  from  the  screen,  but 
any  material  to  its  right  does  not  move  over  to  fill  the  space  left  by  the 
removed  material.  The  space  is  filled  with  the  shaded  work  surface. 
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When  you  are  designing  a  report,  you  can  move  and  copy  material  between 
different  bands.  If  you  are  copying  from  a  layout  band  to  a  wrapping  band, 
simply  make  a  selection,  move  the  cursor  to  the  desired  new  location,  and 
press  F7  Move  or  F8  Copy.  When  you  copy  from  a  wrapping  band  to  a  layout 
band,  you  will  be  able  to  position  the  selection’s  ghost  before  pressing  •*-»•  to 
finish  the  move  or  copy. 

TIP 

If  you  want  dBASE  IV  to  help  wrap  text  that  will  eventually  be  placed 
in  a  layout  band,  you  can  write  the  text  in  a  word  wrap  band,  and 
then  move  it  to  a  layout  band.  Once  the  text  is  moved,  though,  it  will 
no  longer  wrap  automatically. 


As  you  design  forms,  reports,  and  labels,  you  may  want  to  change  the  sizes  of 
fields,  boxes,  or  memo  windows. 

To  change  the  size  of  a  box  or  field,  simply  place  the  cursor  on  the  box  or 
field  and  press  Shift-F7  Size.  A  ghost  of  the  box  or  field  will  appear,  and  you 
can  use  the  arrow  keys  to  change  its  size.  (If  you  are  changing  the  size  of  a 
field,  t  and  i  are  inactive.)  When  the  ghost  of  the  object  is  the  size  you  want, 
press  •«-»•  to  complete  the  process. 

When  you  make  a  field  narrower,  dBASE  IV  removes  template  characters 
from  the  left  side  of  the  template.  When  you  make  a  field  wider,  dBASE  IV 
duplicates  the  character  on  the  left  side  of  the  template. 

For  example,  the  template  !AAAA9999XXXbecomes  A9999XXX if  made  four 
spaces  narrower.  It  becomes  HMAAAA9999XXX i f  made  four  spaces  wider. 


Sizing  Objects 


Adding  Fields  to  the  Work  Surface 

Both  the  word  wrap  and  layout  modes  reflect  the  flexibility  of  dBASE  IV  by 
letting  you  mix  text  with  fields.  The  text  lets  you  include  material  that  stays 
constant,  while  the  data  in  the  fields  can  change. 

You  add  fields  with  the  Add  field  option  from  the  Layout  menu  on  the 
reports,  forms,  and  labels  design  screens.  This  process  is  described  in  detail 
in  Chapters  8,  9,  and  10. 

You  can  also  add  a  field  to  any  of  these  work  surfaces  by  pressing  F5  Field. 
This  key  lets  you  add  a  new  field  to  the  editing  surface.  F5  Field  also  lets  you 
modify  the  current  field. 


Searching  and  Replacing  Text 

Both  the  layout  and  word  wrap  modes  support  search  and  replace  opera¬ 
tions.  These  are  handled  by  the  Go  To  menu.  This  is  the  same  menu  used 
on  the  Browse  and  Edit  screens.  You  can  read  more  about  it  in  Chapter  3, 
“Browse  and  Edit.” 
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The  Go  To  menus  for  the  forms,  reports,  and  labels  design  screens  contain  a 
special  Replace  option,  which  is  also  described  in  Chapter  3,  “Browse  and 
Edit.” 

In  addition  to  the  Replace  option,  you  can  also  use  Shift-F5  Find  and 
Shift-F6  Replace  to  search  and  replace.  You  can  then  continue  the  opera¬ 
tion  to  another  occurrence  by  pressing  Shift-F3  Find  Previous  or 
Shift-F4  Find  Next. 


Special  Keystrokes 

In  layout  mode,  Tab  is  used  to  help  move  the  cursor  quickly  across  the 
screen.  It  does  not  place  an  indent  character  onto  the  surface  or  affect  exist¬ 
ing  text.  In  word  wrap  mode,  Tab  enters  tab  characters,  which  help  you  align 
text  and  fields. 

Home  moves  the  cursor  to  the  beginning  of  the  current  line.  If  the  ruler  has 
an  indent,  the  indentation  symbol  marks  the  beginning  of  the  line.  Other¬ 
wise,  Home  moves  the  cursor  to  the  left  margin.  End  places  the  cursor  just 
after  the  last  character  in  the  current  row. 


Special  Word  Wrap  Mode  Features 

Because  word  wrap  mode  is  designed  to  write  dBASE  IV  programs,  it  has 
special  features  that  help  you  write  lines  of  code. 

Changing  Paragraph  Format  Directly 

The  dBASE  IV  editor  lets  you  format  text  with  a  ruler ,  which  appears  at  the 
top  of  the  screen.  You  can  reformat  text  either  through  menu  options 
described  later  in  this  chapter,  or  by  pressing  CtrigHyphen.  Yon  can  also 
make  changes  to  the  format  of  a  paragraph  directly. 

Once  you  have  started  writing  in  a  paragraph,  you  can  change  its  format 
with  a  few  keystrokes. 

Changing  the  Margins 

If  the  cursor  is  inside  a  paragraph,  you  can  move  the  left  margin  one  tab 
stop  to  the  left  by  pressing  Shift-Tab.  The  paragraph  indentation  will  keep  its 
position  relative  to  the  left  margin. 


USING  THE  MENU  SYSTEM 
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If  you  place  the  indentation  symbol  (#)  to  the  left  of  the  left  margin  symbol 
([)  you  set  up  an  outdent.  For  example,  your  ruler  and  text  might  look  like 
Figure  4-7. 


Figure  4-7  An  outdent  in  word  wrap  mode 

If  the  cursor  is  outside  a  paragraph,  between  the  left  margin  and  an  outdent, 
you  can  move  the  left  margin  to  the  outdent  by  pressing  Shift-Tab. 

If  you  select  several  paragraphs  (or  lines  of  code)  with  F6  Extend  Select,  you 
can  move  the  entire  selection  left  or  right  by  changing  the  margin  for  the 
selection.  The  paragraphs  (or  lines  of  code)  will  maintain  their  relative 
indentation  within  the  extended  selection. 

Changing  the  Indentation 

If  you  have  set  the  Enable  automatic  indentation  option  on  the  Words 
menu  to  ON,  you  can  automatically  change  the  paragraph  indentation.  Sim¬ 
ply  move  the  cursor  to  the  desired  location  for  the  indent  and  start  typing. 
This  establishes  the  new  indentation.  Since  paragraphs  inherit  their  format¬ 
ting  from  the  previous  paragraph,  this  also  becomes  the  indentation  for  your 
next  paragraph. 

You  can  also  change  indentation  by  editing  the  indentation  symbol  on  the 
ruler  line. 
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The  Words  Menu 

The  Words  menu  provides  options 
for  the  editor.  You  will  find  the 
Words  menu  on  the  menu  bars  of 
the  design  screens  for  forms, 
reports,  and  labels.  The  Words 
menu  also  appears  when  you  are 
writing  memo  fields  or  programs. 


Style 

dBASE  IV  supports  two  ways  of  emphasizing  material,  depending  on  whether 
the  object  you  are  designing  is  meant  to  be  printed  or  displayed  on  a  screen. 
Forms  are  screen  objects  designed  to  be  displayed  on  a  monitor.  Reports  and 
labels  are  print  objects  meant  to  be  printed. 

Reports  and  labels  use  the  Style  option,  while  forms  use  the  Display  option. 
The  Style  option  is  dimmed  and  unavailable  when  you  edit  memo  fields,  pro¬ 
grams,  or  forms. 

There  are  six  printing  styles  for  text:  normal,  bold,  underline,  italic,  raised, 
and  lowered.  (Raised  and  lowered  are  often  called  superscript  and  subscript.) 

Before  reports  or  labels  are  printed,  they  can  be  shown  on  the  screen.  Dur¬ 
ing  this  time,  their  print  stylings  are  represented  by  the  color  assigned  to 
Titles. 

When  styled  text  is  printed,  dBASE  IV  instructs  the  printer  how  to  represent 
the  style  you  have  requested.  If  your  printer  does  not  support  italic,  super¬ 
script,  or  subscript,  these  styles  are  shown  as  underlined. 

Besides  these  emphasis  styles,  many  printers  can  support  different  typefaces 
or  fonts.  Typical  fonts  include  Times  Roman  and  Helvetica.  You  can  set  up 
special  fonts  with  settings  in  your  Config.db  file.  See  the  “Customizing 
dBASE  IV”  chapter  in  Language  Reference  for  more  information. 

You  can  combine  emphasis  styles  and  type  fonts,  so  that  a  block  of  text  is 
printed  in  italic  Times  Roman,  while  the  paragraph  underneath  it  appears  in 
bold  Helvetica. 

To  assign  a  style  to  some  existing  text,  select  the  text  you  want  to  style  and 
then  choose  an  option  from  the  Words  menu.  To  change  the  style  of  text  you 
are  about  to  type,  position  the  cursor  at  the  desired  location,  then  choose  the 
option  you  want  from  the  Words  menu. 

To  assign  a  style  to  text  in  a  field,  select  the  field  and  choose  options  from 
the  Words  menu.  Note  that  Raised  (Superscript)  and  Lowered  (Subscript) 
are  mutually  exclusive  and  cannot  be  applied  to  the  same  text  at  the  same 
time.  You  can,  however,  combine  other  styles,  such  as  bold  and  italic. 


USING  THE  MENU  SYSTEM 
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Styling  options  are  available  within  memo  fields  as  well  as  on  the  reports 
design  and  labels  design  work  surfaces.  When  a  report  is  printed,  any  styling 
options  applied  to  a  memo  field  are  combined  with  the  styles  within  the 
memo  field. 


Normal 

This  option  removes  all  styling  from  the  current  selection. 

Bold 

This  turns  bold  styling  off  and  on. 

Underline 

This  turns  the  underline  emphasis  style  on  and  off. 

Italic 

This  turns  italics  on  and  off. 

Raised  (Superscript) 

This  option  turns  on  and  off  a  superscript  printing  style. 

Lowered  (Subscript) 

This  option  turns  on  and  off  a  subscript  printing  style. 

User  Fonts 

To  use  this  option,  you  must  set  up  special  fonts  with  settings  in  your 
Config.db  file.  See  the  “Customizing  dBASE  IV”  chapter  in  Language 
Reference  for  more  information. 

Display 

You  can  assign  colors  to  the  currently  selected  text,  fields,  or  boxes  on  your 
form  with  the  Display  menu.  These  colors  will  then  be  used  when  you  use 
the  form  to  enter  or  retrieve  data. 


NOTE 

This  menu  works  just  like  the  one  you  use  to  customize  the  overall 
colors  of  dBASE  IV.  You  can  find  that  menu  on  the  Settings  menu  bar 
from  the  Tools  menu.  To  read  more  about  customizing  the  colors  of 
dBASE  IV,  see  Chapter  14,  “Tools.  ” 


To  assign  colors  for  reports  and  labels,  use  the  Style  menu. 
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If  you  have  two  monitors  connected  to  your  computer,  you  can  choose  one 
with  a  DISPLAY  <=  command  in  your  Config.db  file  or  the  SET  DISPLAY 
command  from  the  dot  prompt.  You  can  read  more  about  these  commands 
in  the  “Customizing  dBASE  IV”  find  “Settings”  sections  of  Language 
Reference. 

Monochrome  Display 

If  you  are  using  a  monochrome  monitor,  the  Display  menu  lets  you  assign 
an  attribute  to  the  currently  selected  item.  The  attributes  available  are 

Intensity,  Underline,  Reverse  video,  and  Blink. 

The  Intensity  setting  establishes  bold-faced  characters.  The  Reverse  video 
setting  switches  foreground  and  background  colors,  so  that  instead  of  green 
letters  on  a  black  background,  for  example,  you  see  black  letters  on  a  green 
background. 

Color  Display 

If  you  are  using  a  color  monitor,  this  menu  option  lets  you  assign  fore¬ 
ground  and  background  colors  to  the  currently  selected  item.  You  can  assign 
1  of  16  colors  to  its  foreground,  and  1  of  8  colors  to  its  background.  You  can 
also  turn  on  the  blinking  attribute. 

You  choose  your  colors  from  an  electronic  palette.  In  the  Foreground  col¬ 
umn,  the  name  of  each  available  color  is  shown  in  its  own  color,  against  the 
current  background  color.  The  word  Blue,  for  example,  is  always  shown  in 
blue  letters. 

In  the  Background  column,  each  available  color  is  used  to  make  its  own 
background,  while  the  name  of  the  color  is  shown  in  the  currently  selected 
foreground  color.  The  word  Green,  for  example,  always  appears  against  a 
green  background. 

You  choose  foreground  and  background  colors  by  moving  the  greater-than 
character  (>  )  up  and  down  the  columns. 

Suppose  you  want  a  yellow  foreground  color.  Move  the  greater-than  charac¬ 
ter  in  the  Foreground  column  to  the  word  Yellow.  This  selects  yellow  as  the 
foreground  color.  All  the  words  in  the  Background  column  will  be  shown  in 
yellow  letters. 

Now  press  -*■,  or  •«-»•  to  move  the  cursor  to  the  Background  column  so 
you  can  pick  a  background  color.  Look  over  the  column  to  see  which  back¬ 
ground  colors  make  a  nice  combination  with  a  yellow  foreground. 

Suppose  you  decide  on  a  blue  background.  Move  the  greater-than  character 
in  the  Background  column  until  it  is  next  to  the  word  Blue.  Now  you  have 
selected  a  blue  background  to  go  with  your  yellow  foreground. 

Notice  that  the  new  color  combination  is  displayed  twice,  once  in  the 
Foreground  column,  once  in  the  Background  column.  The  advantage  of 
this  electronic  palette  is  that  you  can  quickly  see  many  color  combinations 
at  one  time. 


USING  THE  MENU  SYSTEM 
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By  moving  the  greater-than  character  up  and  down  the  Background 
column,  you  can  try  all  the  background  colors.  By  moving  the  greater-than 
character  up  and  down  the  Foreground  column,  you  can  try  all  the  fore¬ 
ground  colors. 

To  toggle  the  Blink  attribute  on  and  off,  press  the  letter  B.  When  you  have 
selected  both  the  foreground  and  background  color  you  want,  press  Ctrl-*-*-. 

Position 

With  the  Position  option,  you  can  move  text  within  the  current  margins. 
When  you  select  this  option,  a  submenu  appears  containing  the  options  Left, 
Centered,  and  Right. 

On  the  word  wrap  surface,  the  selected  paragraphs  are  moved  to  the  left 
margin,  to  the  center,  or  to  the  right  margin.  If  the  current  line  is  empty,  the 
cursor  is  simply  moved. 

In  layout  text,  if  more  than  one  character  or  field  is  selected,  the  selected 
material  is  positioned  between  the  nearest  text  or  field  to  the  left  and  right. 
If  just  one  character  is  selected,  the  entire  line  is  moved  to  the  left  margin, 
to  the  center,  or  to  the  right  margin,  just  as  in  word  wrap  text. 


Modify  Ruler  (Reports,  Forms,  Labels) 

The  Modify  ruler  option  moves  the  cursor  to  the  ruler  line,  where  you  can 
modify  the  left  and  right  margins,  the  paragraph  indentation,  and  tab  stops. 
If  the  ruler  line  is  turned  off  when  this  option  is  chosen,  the  ruler  is  first 
turned  on. 

Although  the  left  and  right  margins  are  principally  used  for  word  wrap  edit¬ 
ing,  they  can  be  used  in  layout  editing  to  center  text  or  align  text  to  the  left 
or  right  margin.  In  reports  word  wrap  bands,  margins,  indentation,  and  tabs 
are  set  by  paragraph.  The  ruler  always  reflects  the  current  or  selectecfjpara- 
graphs. 

Navigating  the  Ruler 

You  can  move  along  the  ruler  with  the  cursor  keys.  In  addition,  Ctrl — *  and 
Ctrl--*-  move  the  cursor  right  and  left  eight  spaces.  Tab  and  Shift-Tab  move 
the  cursor  right  and  left  one  tab  stop,  respectively. 

Modifying  the  Ruler 

You  set  the  left  margin  by  pressing  [  at  the  desired  location,  the  right  margin 
by  pressing  ].  The  margins  are  represented  on  the  ruler  by  [  and  ].  The 
maximum  and  default  widths  for  various  word  wrap  objects  are  shown  in 
Table  4-2. 
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Table  4-2  Widths  in  word  wrap  objects 


Object 

Default  width 

Maximum  width 

Memo  field 

Width  of  current 
memo  window 

1,024  characters 

Report 

255  characters 

255  characters 

Program  editor 

(MODIFY  COMMAND) 

1,024  characters 

1,024  characters 

Tfext  editor 

(MODIFY  FILE) 

80  characters 

255  characters 

Zoom 

(SQL  prompt) 

1,024  characters 

1,024  characters 

History 

1,024  characters 

1,024  characters 

(dot  prompt) 


You  set  the  paragraph  indentation  by  pressing  #.  The  paragraph  indentation 
point  is  relative  to  the  left  margin,  so  if  you  change  the  left  margin,  the 
indentation  moves  automatically.  Of  course,  the  paragraph  indentation  point 
can  be  moved  without  affecting  the  left  margin. 

You  set  tabs  by  typing  !  at  the  desired  location,  and  clear  tabs  by  pressing 
Del.  Tabs  are  represented  on  the  ruler  by  triangles  (ASCII  31).  If  you  want  to 
set  tabs  at  a  specified  interval,  type  =  while  still  on  the  ruler.  You  will  be 
prompted  to  enter  the  number  of  spaces  you  want  between  tabs.  If  you  enter 
zero,  then  no  tabs  will  appear  on  the  ruler.  Tabs  can  only  be  set  and  cleared 
through  the  ruler. 

If  you  want  to  abandon  the  changes  you  just  made,  press  Esc.  If  you  want  to 
keep  your  changes,  press  Ctrl-End. 

Hide  Ruler 

This  option  controls  whether  the  ruler  line  is  displayed.  If  displayed,  the 
ruler  line  appears  just  below  the  menu  bar. 

Enable  Automatic  Indent 

Paragraphs  always  inherit  the  formatting  of  the  previous  paragraph.  This 
option  lets  you  reset  the  indentation  point  to  wherever  you  start  typing  the 
opening  line  of  the  current  paragraph. 

This  option  is  not  available  for  the  layout  editing  mode. 

Add  Line 

The  Add  line  option  adds  a  new  line  following  the  current  line.  In  word 
wrap  editing,  this  command  closes  the  current  paragraph  and  moves  the  cur¬ 
sor  to  the  beginning  of  the  next  line. 


USING  THE  MENU  SYSTEM 
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In  layout  editing,  this  option  adds  a  new  line  to  the  layout,  expanding  the 
layout  by  one  line.  The  cursor  remains  in  its  current  column,  but  is  reposi¬ 
tioned  to  the  next  line.  Since  labels  have  a  fixed  height,  this  option  is 
unavailable  on  the  labels  design  screen. 

Remove  Line 

The  Remove  line  option  removes  the  current  line.  In  word  wrap  mode,  this 
is  equivalent  to  selecting  all  the  characters  on  the  current  line  and  pressing 
Del.  In  layout  mode,  this  option  removes  the  current  line  and  its  contents 
from  the  screen,  contracting  the  layout  by  one  line. 

Insert  Page  Break 

This  option  inserts  a  page  break  into  word  wrap  text,  just  above  the  current 
line.  It  is  not  available  for  layout  editing. 

Reading  and  Writing  Text  Files 

These  options  let  you  exchange  text  between  a  design  surface  and  other  files. 

Write  Selection  to  File 

The  Write  selection  to  file  option  prompts  for  a  filename,  and  then  writes 
the  current  selection  to  that  disk  file.  If  there  is  no  current  extended  selec¬ 
tion,  the  entire  text  or  layout  is  written  to  the  disk  file. 

Read  Text  from  File 

This  option  prompts  for  a  filename,  then  inserts  the  contents  of  the  specified 
file  into  the  text  or  the  layout  surface  at  the  current  position,  as  if  the  text 
were  typed  in. 
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Printing 


Introduction  to  Printing 

dBASE  IV  offers  you  several  ways  to  send  data  to  your  printer.  You  can  print: 

■  Quick  Reports  to  quickly  show  the  data  from  each  field  of  a  database  file 
or  view 

■  Custom  reports  to  group,  summarize,  and  present  data  to  your 
specifications 

■  Form  letters,  to  combine  repeating  text  with  individualized  data 

■  Data  from  specific  records 

■  Mailing  labels 

Most  of  your  layout  decisions  about  reports  or  labels  are  made  when  you 
design  them  on  the  screen.  Printing  reports  and  labels  then  becomes  a  sim¬ 
pler  routine,  letting  you  focus  on  printer  and  paper  questions. 

You  can  read  how  to  design  reports  and  form  letters  in  Chapter  9, 

“Designing  Reports.”  You  can  read  how  to  design  labels  in  Chapter  10, 
“Designing  Labels.” 

Once  you  have  set  up  a  report  or  label  to  print  a  certain  way,  you  can  cap¬ 
ture  the  current  print  settings  and  use  them  for  other  reports  or  labels.  Sev¬ 
eral  printing  features  are  built  into  reports  and  labels.  For  example,  a  closed 
report  band  will  not  be  printed. 

While  dBASE  IV  will  control  page  breaks,  you  are  responsible  for  making 
sure  the  paper  in  your  printer  is  wide  enough  to  handle  the  labels  and 
reports  you  print. 

Different  items  in  dBASE  IV  have  similar  menus  for  printing.  The  “Using  the 
Print  Menu”  section  describes  the  basic  Print  menu.  This  “Introduction  to 
Printing”  section  covers  minor  differences  that  occur  between  the  various 
versions  of  the  Print  menu. 

The  Print  menu  contains  options  to  change  the  quality  and  pitch  of  your 
text.  You  can  set  more  specific  styling  attributes  with  the  Style  submenu  of 
the  Words  menu.  If  your  printer  does  not  support  italic,  superscript,  or  sub¬ 
script,  dBASE  IV  prints  them  as  underlined  characters.  You  can  read  more 
about  the  Style  submenu  in  Chapter  4,  “The  Editors.” 
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Reaching  a  Print  Menu  from  the  Control  Center 

From  the  Control  Center,  you  can  reach  a  Print  menu  by: 

■  Pressing  on  the  name  of  a  file  in  the  Labels  or  Reports  panels.  If  the 
panel  prompt  box  appears,  select  Print  report  or  Print  label. 

■  Selecting  the  Print  menu  when  designing  a  report,  label,  or  application. 

■  Pressing  Shift-F9  Quick  Report  when  the  cursor  is  on  the  name  of  a  file 
in  any  Control  Center  panel  except  Applications. 

■  Pressing  Shift-F9  Quick  Report  from  the  Browse/Edit  screen  or  the  que¬ 
ries  design  screen.  (This  works  only  if  you  came  to  these  screens  directly 
from  the  Control  Center  or  dot  prompt.) 

Printing  from  the  Dot  Prompt 

When  you  issue  the  REPORT  FORM  TO  PRINTER  or  LABEL  FORM  TO 
PRINTER  commands,  the  Print  menu  does  not  display.  These  commands 
immediately  begin  printing  the  requested  report  or  label.  You  can  reach 
a  Print  menu  when  you  use  a  work  surface  to  design  a  report,  label,  or 
application. 

You  can  print  data  from  the  dot  prompt  directly  by  adding  the  TO  PRINTER 
option  to  commands  such  as  DISPLAY,  LIST,  and  TYPE.  The  SET  PRINT  ON 
command  also  lets  you  send  the  output  of  many  dBASE  IV  functions  to  your 
printer. 


Printing  a  Quick  Report 

dBASE  IV  offers  you  a  fast  and  easy  way  to  print  basic  reports.  These  Quick 
Reports  organize  and  print  data  from  the  current  view  or  database  file  or 
from  the  database  file  or  view  associated  with  a  form,  report,  or  label. 

You  generate  a  Quick  Report  by  pressing  Shift-F9  Quick  Report  from  the 
Control  Center,  the  Browse/Edit  screen,  or  the  queries  design  screen.  A 
Print  menu  appears  that  you  can  use  to  make  last-minute  printing  choices. 
When  you  are  satisfied  with  the  choices,  choose  the  Begin  printing  option. 
dBASE  IV  then  prints  a  Quick  Report. 

When  the  Print  menu  first  appears,  the  cursor  already  marks  the  Begin 
printing  option.  If  the  indicated  choices  are  satisfactory,  simply  press  ■«-*■  to 
begin  printing.  If  you  want  to  change  the  settings,  move  the  cursor  to  the 
desired  option.  If  you  decide  not  to  make  a  Quick  Report,  press  Esc. 


NOTE 

If  you  press  Shift-F9  Quick  Report  from  the  reports  design  screen, 
dBASE  IV  beeps.  Tb  print  the  report  shown  on  the  reports  design 
screen,  use  the  reports  design  screen’s  Print  menu. 
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Quick  Report  Appearance 

A  Quick  Report  produces  a  series  of  colum  ns,  showing  the  data  in  each  field 
of  the  current  database  file  or  view. 


Each  column  is  labeled  with  the  name  of  a  field.  The  columns  print  at  least 
as  wide  as  the  field  widths.  If  a  field’s  name  (including  a  space  on  each  side) 
is  longer  than  its  width,  the  column  is  made  wider  to  accommodate  the  field 
name.  Each  numeric  field  is  summed  in  the  Quick  Report’s  summary  band. 

If  a  report  is  wider  than  the  width  available  from  your  printer,  what  happens 
next  depends  on  how  your  printer  handles  lines  that  are  too  long.  You 
should  design  your  reports  so  they  will  fit  on  your  printer. 

Printing  the  Structure  of  a  Database  File 

After  designing  a  database  file,  you  will  often  want  to  have  a  printed  copy  of 
its  structure.  You  can  print  the  structure  of  a  database  file  by  choosing  the 
Print  database  structure  option  from  the  Layout  menu  on  the  database 
design  screen.  When  you  choose  this  option,  the  Print  menu  displays,  and 
you  can  change  printing  attributes  before  printing  the  database  structure. 

Printing  a  Program 

You  can  print  programs  from  the  program  editor  or  the  debugger  screen. 
The  Print  menu  for  applications  is  similar  to  the  other  Print  menus 
described  in  the  “Using  the  Print  Menu”  section. 

The  Print  menu  for  applications  has  one  extra  option,  the  Line  numbers 
option.  If  you  set  this  option  ON,  line  numbers  print  to  the  extreme  left  of 
each  line. 
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Using  the  Print  Menus  for  Labels  and  Reports 

Even  though  labels  and  reports  look  quite  different,  they  have  almost  identi¬ 
cal  Print  menus.  This  is  because  many  of  the  printing  attributes  unique  to 
reports  or  labels  are  contained  on  other  menus  on  their  design  screens. 

The  Print  menu  for  labels  does  have  one  additional  feature,  the  Generate 
sample  label  option.  This  option  is  described  in  the  next  section,  along  with 
other  slight  differences  between  the  labels  and  reports  versions  of  the  Print 
menu. 

The  Print  Menu 


The  consistency  of  the  Print  menu 
simplifies  the  process  of  dealing 
with  your  printer.  It  is  almost  iden¬ 
tical  whether  you  are  printing  a 
report,  label,  application,  or  data¬ 
base  structure.  The  major  differ¬ 
ences  in  menu  options  are 
described  in  the  previous  section, 
“Introduction  to  Printing.” 


Begin  Printing 

This  option  tells  dBASE  IV  to  start  printing.  If  the  settings  on  the  menu  are 
the  ones  you  want,  this  is  the  only  option  you  need  to  choose. 

You  can  halt  the  printer  in  two  ways: 

■  Press  Ctrt-S  to  pause  printing  temporarily 

■  Press  Esc  to  stop  printing  entirely 


NOTE 

If  you  are  using  a  print  buffer,  the  printer  may  not  stop  immediately 
after  you  press  either  of  these  keys.  This  is  because  the  data  still  in  the 
buffer  may  have  to  print  out  first.  If  this  happens,  reset  your  printer  by 
turning  it  off  and  on. 


Eject  Page  Now 

This  menu  option  makes  the  printer  eject  a  page.  This  helps  you  start  and 
end  pages  at  their  perforations.  You  can  also  eject  a  page  automatically  by 
selecting  the  New  page  option  from  the  Control  of  printer  submenu. 


5-4 


PRINTING 


PAGE:  5  SESS:  4  Fr  l  May  20  13:12:27  1  988 
k2/al I Jobz/CLS_HiBnhat/GRP_manhBt/J0B_mBnusemen/DIV_umchap5 

View  Report  on  Screen/View  Labels  on  Screen 

This  menu  option  helps  you  see  what  your  reports  or  labels  will  look  like 
when  printed.  You  can  also  check  that  all  fields  are  properly  defined.  When 
you  select  this  option,  the  report  or  labels  are  shown  on  the  screen  in  the 
same  format  as  they  will  be  printed.  Reports  and  labels  are  shown  one 
screenful  at  a  time,  and  if  they  are  wider  than  your  screen,  the  text  will  wrap 
to  the  next  line. 

Generate  Sample  Label 

This  menu  option  is  available  only  on  the  Print  menu  for  labels.  It  helps  you 
check  the  alignment  between  your  labels,  printer,  and  label  design. 

When  you  select  this  option,  dBASE  IV  sends  a  sample  label  to  the  printer. 
You  can  then  make  sure  the  label  is  printing  properly  before  printing  the 
whole  job.  If  you  are  printing  more  than  one  label  in  a  row,  this  option  will 
print  a  row  of  labels. 

You  may  continue  printing  sample  labels  until  your  alignment  is  correct. 
When  you  indicate  that  the  sample  labels  are  printing  satisfactorily, 
dBASE  IV  will  start  printing  your  labels  from  the  beginning. 

Use  Print  Form 

This  option  lets  you  automatically  set  up  your  print  settings,  based  on  a  pro¬ 
file  of  print  settings  previously  saved.  For  example,  if  you  have  a  report  that 
always  prints  three  copies  and  requires  special  printer  control  codes,  you 
can  save  these  settings  to  a  print  form.  You  can  then  load  this  print  form  to 
automatically  install  your  print  settings. 

When  you  choose  this  option,  you  can  select  the  name  of  a  print  form  from  a 
list  on  the  screen  of  all  the  .prf  files. 

Save  Settings  to  Print  Form 

This  option  lets  you  create  or  modify  a  print  form  that  stores  a  collection  of 
print  settings.  After  you  choose  this  option,  you  can  save  the  new  settings  to 
the  current  print  form.  You  can  also  change  the  name  and  store  these  set¬ 
tings  to  a  new  print  form. 


NOTE 

If  you  change  most  print  settings,  dBASE  IV  will  automatically  ask 
when  you  save  the  report  or  label  if  you  want  to  save  these  new  set¬ 
tings  to  a  print  form.  The  four  options  you  can  change  without  being 
asked  to  save  the  changes  are:  Echo  to  screen,  Begin  on  page,  End 
after  page,  and  Number  of  copies. 
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The  Destination  Submenu 

This  submenu  lets  you  determine  where  to  send  the  print  file.  You  can  print 
data  to  different  printers,  to  a  file,  or  to  the  screen. 

Write  To 

This  option  lets  you  determine  whether  to  send  the  print  file  to  a  printer  or 
DOS  file.  You  can  print  the  report  or  label  from  a  DOS  file  at  another  time 

or  place. 

If  you  choose  DOS  file,  a  file  will  be  created  to  meet  the  requirements  of  the 
printer  shown  in  the  Printer  model  option.  This  means  you  can  print  the  file 
using  the  TYPE  <  filename  >  PRN  command  from  DOS,  since  all  necessary 
control  codes  are  saved  with  the  text. 

You  can  also  send  the  file  on  a  disk  or  by  telecommunication  devices  to 
some  other  printing  location. 

Name  of  DOS  File 

dBASE  IV  will  use  the  name  shown  here  whenever  you  print  to  a  DOS  file.  If 
you  have  not  entered  your  own  filename,  dBASE  IV  will  suggest  a  name 
based  on  the  name  of  the  report  or  label. 

The  extension  of  this  suggested  name  is  usually  .prt.  If  you  choose  ASCII  text 
with  the  Printer  model  option,  the  suggested  extension  will  be  .txt.  You  can, 
however,  modify  this  name  by  pressing  -«-»■  and  editing  the  name  or  entering 
a  new  one. 

Suppose  you  are  printing  the  Invoice  report  to  a  DOS  file  and  select  HP 
Laser  as  the  type  of  printer.  The  suggested  name  for  the  file  is  the*nJlnvoi- 
ce.prt.  If  you  change  Printer  model  to  ASCII  text,  then  the  suggested  file¬ 
name  becomes  Invoice.txt. 

Printer  Model 

dBASE  IV  must  know  the  typ(  of  printer  you  want  to  use.  Even  if  you  are 
printing  to  a  DOS  file,  this  option  embeds  the  correct  printer  control  codes 
so  the  file  can  be  used  on  the  printer  you  want. 

When  you  install  dBASE  IV,  you  can  specify  up  to  five  printers,  in  addition 
to  ASCII  text.  Your  choices  in  the  Printer  model  option  depend  on  the 
printers  you  installed  earlier. 

You  always  have  the  choice  called  ASCII  text.  Use  this  choice  when  you 
want  to  send  a  file  by  a  form  of  electronic  mail  that  cannot  handle  printer 
control  codes,  or  when  you  must  produce  an  ASCII  file. 

Echo  to  Screen 

When  you  set  this  option  to  YES,  the  report  or  label  will  be  shown  on  your 
monitor  at  the  same  time  as  it  is  sent  to  an  electronic  file  or  a  printer. 
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The  display  on  your  screen  has  been  formatted  for  the  printer  and  may 
appear  differently  on  your  screen  from  the  way  it  prints  out.  It  is  only 
intended  to  let  you  see  approximately  how  the  report  or  set  of  labels  is 
proceeding. 

The  Control  of  Printer  Submenu 

The  options  on  this  submenu  help  you  give  special  instructions  to  the 
printer.  They  cover  three  basic  areas:  the  size  and  quality  of  the  printing,  the 
way  new  pages  are  handled,  and  special  codes  needed  to  initiate  the  printer. 

Text  Pitch 

You  have  four  choices:  Pica,  Elite,  Condensed,  and  Default. 

Pica  is  larger  than  Elite.  It  has  10  characters  per  inch,  while  Elite  has  12 
characters  per  inch.  Condensed  is  even  smaller,  with  the  exact  number  of 
characters  per  inch  depending  on  your  printer.  The  Default  choice  lets  you 
use  the  current  printer  pitch. 

Quality  Print 

If  set  to  YES,  the  printer  will  use  its  best  (near  letter  quality)  printing.  If  set 
to  NO,  the  printer  will  use  its  fastest  (draft)  printing.  If  set  to  Default,  the 
printer  will  maintain  its  current  quality  level. 

New  Page 

You  can  control  how  extra  pages  are  emitted  with  form  feeds  from  your 
printer.  Pages  can  be  ejected  Before  the  report  or  labels  are  printed,  After 
they  are  printed,  or  Both  before  and  after. 

None  tells  dBASE  IV  not  to  feed  any  extra  pages. 

Wait  Between  Pages 

If  you  have  a  sheet-feed  printer  that  takes  each  page  separately,  you  can  use 
this  option  to  tell  the  printer  to  wait  after  each  page  so  you  can  insert  the 
next  one.  This  is  useful  if  you  want  to  print  a  report  or  labels  on  different 
types  of  paper. 

Advance  Page  Using 

Form  feeds  tells  the  printer  to  start  a  new  page  by  moving  to  the  top  of  the 
next  form.  Line  feeds  tells  the  printer  to  advance  to  the  top  of  the  next  page 
by  the  precise  number  of  lines  needed  to  fill  out  the  page  height.  These  set¬ 
tings  are  useful  if  your  paper  height  is  not  one  of  the  standard  form  heights 
supported  by  your  printer. 

Starting  Control  Codes 

Printer  control  codes  allow  you  to  tell  your  printer  to  do  certain  things  not 
on  the  Print  menu. 
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You  can  type  the  codes  in  directly  from  the  keyboard.  Characters  with  ASCII 
codes  less  than  32,  such  as  Esc,  cannot  be  entered  by  simply  pressing  their 
keys  on  the  keyboard.  You  can,  however,  type  their  ASCII  codes  inside  curly 
braces  like  this:  {27}.  Characters  entered  without  curly  braces  will  be  sent 
directly  to  the  printer. 

Many  printer  control  codes  begin  with  Esc.  Atypical  printing  control  code 
to  signal  top  of  form  might  be  {2 7 }5 .  You  can  find  a  table  of  ASCII  codes  in 


the  on-screen  Help  system,  as  well  as  in  Appendix  G  of  Language  Reference. 

To  simplify  this  process,  certain  keystrokes  can  be  typed  inside  curly  braces 
with  their  everyday  names.  For  example,  Esc  can  be  sent  to  the  printer 
either  by  its  ASCII  code  {27}  or  by  the  mnemonics  {esc}  or  {escape}. 

Table  5-1  Control  codes  albwed  inside  curly  braces 

Code 

ASCII  Number 

NULL 

0 

BELL 

7 

BACKSPACE 

8 

TAB 

9 

RETURN 

13 

ESC  or  ESCAPE 

27 

{ 

123 

DEL  or  DELETE 

127 

0  through  255 

0  through  255 

Ending  Control  Codes 

These  codes  are  entered  the  same  way  as  the  starting  control  codes.  They  let 
you  reset  the  printer  to  its  original  settings. 


The  Output  Options  Submenu 

This  submenu  lets  you  control  the  number  of  copies  printed,  as  well  as 
which  pages  are  printed. 

Begin  on  Page 

This  option  tells  the  printer  to  start  printing  on  the  page  number  you 
request.  It  is  usually  set  for  page  number  1,  but  you  can  set  it  to  be  some 
page  after  the  first  one.  (There  is  no  page  zero.)  The  maximum  settinglis 
32,767. 

After  you  print  a  report  or  set  of  labels,  this  number  automatically  resets  to 
the  starting  number  stored  in  the  current  print  form. 
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End  After  Page 

The  printer  stops  printing  after  it  prints  this  page.  After  you  print  a  report  or 
set  of  labels,  this  number  automatically  resets  to  the  ending  number  in  the 
current  print  form.  The  maximum  setting  is  32,767,0*" 

First  Page  Number 

You  can  use  this  option  to  make  your  printer  assign  a  particular  page  num¬ 
ber  to  the  first  page  printed  for  the  current  report.  This  is  useful  if  you  are 
printing  a  document  composed  of  several  reports,  and  you  want  all  the  pages 
to  be  numbered  consecutively. 

Number  of  Copies 

This  option  is  useful  if  you  need  to  print  more  than  one  copy  of  a  report  or 
set  of  labels.  If  you  are  printing  to  a  DOS  file,  only  one  copy  will  be  written 
to  the  file  because  you  can  simply  print  the  one  DOS  file  over  again. 

After  you  print  a  report  or  set  of  labels,  the  number  of  copies  autom  atically 
resets  to  whatever  is  specified  in  the  current  print  form. 

The  Page  Dimension  Submenu 

This  submenu  helps  you  define  how  text  is  placed  on  the  page. 

Length  of  Page 

This  option  defines  the  height  of  a  page  by  the  number  of  single-spaced  lines 
that  can  fit  on  it.  A  typical  sheet  of  paper  usually  has  room  for  66  lines.  You 
can,  however,  make  this  setting  as  large  as  32,767  lines. 

Offset  from  Left 

This  option  tells  dBASE  IV  where  to  start  printing  horizontally  on  the  page. 

It  establishes  where  column  zero  for  report  layout  bands  and  labels  will  be 
on  the  printed  page. 

In  word  wrap  mode,  the  position  of  the  first  printed  column  is  the  sum  of 
this  left  offset  and  the  left  margin  set  on  the  ruler.  For  example,  if  you  want 
the  first  characters  to  appear  10  spaces  from  the  edge  of  the  paper,  you 
could  have  a  left  offset  of  10  and  a  left  margin  on  the  word  wrap  ruler  of 
zero.  You  could  also  have  a  left  offset  of  five  and  a  left  margin  of  five. 

The  maximum  setting  available  is  32,767  columns. 
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Dot  prompt  equivalent  command 
SET  MARGIN  =  10 


Spacing  of  Lines 

This  option  controls  the  spacing  between  printed  lines.  You  can  choose 
between  single,  double,  or  triple  line  spacing. 


Set  with  Print /Page 
dimensions  menu 

•  Width  of  page 

•  Offset  from  left 

•  Spacing  of  lines 


Set  with  ruler  at 
top  of  page 


•  left  margin 

•  right  margin 

•  indentation 


Figure  5-2  A  scherr  atic  of  a  printed  page 
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Designing 

Databases 


Introduction  to  Designing  Database  Files 

Database  files  contain  the  data  used  by  dBASE  IV.  They  are  also  the  raw 
material  for  views,  which  in  turn  support  reports,  labels,  and  forms.  You  use 
the  database  design  screen  to  modify  the  structure  of  an  existing  database 
file  or  create  a  new  database  file. 

On  the  database  design  screen,  you  can  add  or  remove  index  files,  sort  data, 
append  data,  and  erase  records  marked  for  deletion. 
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Figure  6-1  The  database  design  work  surface 


The  database  design  work  surface  consists  of  a  table  in  which  each  row  rep¬ 
resents  a  field  in  the  current  database  file.  The  columns  show  each  field’s 
attributes. 
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How  to  Reach  This  Screen 

You  can  reach  the  database  design  screen  both  from  the  Control  Center  and 
from  the  dot  prompt. 

From  the  Dot  Prompt 

To  reach  the  database  design  screen  from  the  dot  prompt,  type  CREATE 
<  filename  >  or  MODIFY  STRUCTURE.  If  no  database  file  is  in  use, 
dBASE  IV  will  ask  you  to  enter  the  name  of  the  file  containing  the  structure 
you  want  to  modify. 

From  the  Control  Center 

To  reach  the  database  design  screen  from  the  Control  Center,  move  the 
cursor  to  the  <  create >  marker  in  the  Data  panel  and  press  ♦-►.  You  can 
then  create  a  new  database  file. 

You  can  also  move  the  cursor  to  the  name  of  an  existing  file  in  the  Data 
panel  and  press  Shift-F2  Design.  Since  the  database  file  already  exists,  the 
Organize  menu  will  be  pulled  down  when  the  database  design  screen 
appears.  This  helps  you  work  with  database  file  indexes  while  preventing 
you  from  inadvertently  modifying  database  structures. 


Typical  Uses 

The  database  design  screen  lets  you: 

■  Create  new  database  files  or  modify  existing  ones 

■  Index  and  sort  the  records  in  a  database 

■  Add  groups  of  records 

■  Erase  records  m  arked  for  deletion 

■  Print  a  copy  of  the  database  file’s  structure 

■  Edit  the  file’s  description 


Using  the  Database  Design  Work  Surface 

You  can  define  the  fields  in  a  database  file  by  modifying  or  expanding  the 
information  in  the  rows  and  columns  on  the  database  design  work  surface. 


Designing  and  Editing  Fields 

The  Num  column  contains  the  position  of  the  field  in  the  database  file’s 
structure.  You  cannot  change  this  information,  which  is  for  reference  only. 
You  can  use  this  number  to  move  the  cursor  directly  to  a  particular  field. 
Choose  the  Go  To  menu  and  select  the  Field  number  option.  You  can  then 
enter  the  number  of  a  field  you  want  to  reach. 
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Field  Name 

The  Field  Name  column  contains  the  name  you  want  to  give  a  field.  Simply 
type  in  the  name.  Field  names  can  contain  up  to  10  letters,  digits,  or  under¬ 
scores.  The  first  character  must  be  a  letter,  and  the  field  name  cannot  con¬ 
tain  embedded  blanks. 

Reid  Type 

The  Field  Type  column  describes  the  type  of  field  to  be  created.  You  choose 
the  type  by  pressing  Spacebar  to  cycle  through  the  choices,  or  by  entering 
the  first  letter  of  the  desired  field  type. 

There  are  six  types  of  fields:  Character,  Numeric,  Float,  Date,  Logical,  and 
Memo. 

Character  fields  can  hold  up  to  254  ASCII  characters  or  digits. 

Numeric  and  Float  are  the  two  ways  dBASE  IV  lets  you  store  numbers. 

Each  is  useful  in  certain  situations. 

Numeric  fields  store  fixed  numbers.  Use  fixed  numbers  when  you  want  an 
exact  number  with  no  possibility  of  rounding  errors.  These  numbers  work 
very  fast  when  you  are  counting  things  or  doing  budgets  that  must  balance  to 
the  penny. 

Fixed  numbers  also  allow  you  to  do  addition  and  subtraction  quickly.  They 
are  often  called  binary  coded  decimal.  These  numbers  are  the  type  you  use 
most  often  in  dBASE  IV. 

Float  fields  store  floating  numbers,  which  are  typically  used  in  scientific 
applications.  They  can  speed  up  operations  involving  frequent  multiplying 
and  dividing,  especially  when  you  work  with  numbers  that  are  very  large  or 
very  small. 


Date  fields  use  eight  spaces  in  the  database  structure  to  hold  a  year,  month, 
and  day.  Independence  Day  in  the  United  States,  for  example,  would  be 
stored  internally  by  dBASE  IV  as  17760704.  You  can  adjust  the  way  dates  are 
presented  on  your  screen  or  in  your  reports.  Normally,  the  date  for  Indepen¬ 
dence  Dav  would  appear  as  07/04/76. 


Logical  fields  take  up  one  space  and  contain  either  True  or  False.  You  can 
indicate  their  meaning  by  entering  T,  F,  t,  or  f.  You  can  also  enter  Y,  N,  y, 
and  n.  The  last  four  entries  stand  for  Yes  and  No.  When  dBASE  IV  stores  a 
value  to  a  logical  field,  it  always  simplifies  the  entry  and  stores  it  as  either  T 
or  F. 
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Memo  fields  are  10  characters  wide.  They  don’t  actually  contain  data,  but 
you  can  use  them  to  write  documents  up  to  64  Kilobytes  long.  A  memo  field 
is  really  a  pointer  to  where  the  text  is  stored  in  a  special  memo  file.  This  file 
has  the  same  name  as  its  associated  database  file,  but  with  an  extension  of 
.dbt  rather  than  .dbf. 


When  you  work  with  memo  fields,  dBASE  IV  keeps  track  of  the  .dbt  file  asso¬ 
ciated  with  a  .dbf  file.  When  you  are  working  outside  of  dBASE  IV,  you  are 
responsible  for  keeping  the  .dbf  file  and  its  .dbt  file  together. 

For  example,  if  you  are  using  the  DOS  COPY  command  to  copy  a  .dbf  file 
that  contains  memo  fields,  be  sure  to  copy  the  .dbt  file  that  goes  along  with 
this  database  file.  Otherwise,  the  material  you  entered  into  your  memo  fields 
will  be  lost. 

Whenever  you  try  to  use  a  database  file  (.dbf)  that  does  not  have  its  memo 
file  (.dbt),  you  will  see  an  error  message. 


M  WARNING 

If  you  are  using  a  database  file  from  dBASE  III  PLUS  that  has  memo 
fields,  any  memo  fields  which  store  more  than  64K  of  text  will  be 
truncated  to  fit  the  dBASE  IV  limit  of  64K  per  memo  field. 

If  there  is  a  possibility  that  any  of  the  memo  fields  in  the 
dBASE  III  PLUS  database  file  may  be  storing  over  64K  of  text,  you 
should  make  a  backup  of  the  dBASE  III  PLUS  .dbt  file  for  safety 
before  using  the  database  file  in  dBASE  IV. 


Further  details  about  field  types  are  available  in  the  “Commands”  section  of 
Language  Reference. 

Width 

The  Width  column  defines  how  many  characters  or  digits  can  be  stored  in 
the  current  field.  Enter  this  amount  by  typing  it  in. 

Character  fields  may  contain  up  to  254  characters,  while  floating  and  fixed 
fields  can  be  up  to  20  digits  wide.  The  widths  for  date,  logical,  and  memo 
fields  are  entered  automatically.  Date  fields  are  8  positions  wide,  logical 
fields  1  position  wide,  and  memo  fields  10  positions  wide. 

Dec 

The  Dec  column  lets  you  define  the  number  of  decimal  places  for  each  fixed 
or  floating  field.  Floating  and  numeric  fields  can  have  from  zero  to  18  deci¬ 
mal  places. 
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The  number  of  decimal  places  assigned  to  floating  and  numeric  fields  must 
be  at  least  two  less  than  their  width.  Floating  fields  need  the  two  extra  spaces 
for  the  decimal  point  and  either  a  digit  to  the  left  of  the  point  or  a  minus 
sign.  Numeric  fields  use  the  two  extra  spaces  for  the  decimal  place  and  a 
digit  to  the  left  of  the  decimal  place. 

Index 

The  Index  field  is  a  new  part  of  the  database  file  structure.  If  you  put  a  y  or 
Tin  a  row  of  this  column,  dBASE  IV  creates  an  index  tag  based  on  the  value 
of  the  field  described  by  that  row. 


Required  Reid  Attributes 

You  must  always  fill  in  Field  Name  and  Field  Type.  Most  fields  also  require 
an  assigned  width.  The  memo,  logical,  and  date  fields  have  pre-assigned 
widths. 

If  you  try  to  move  out  of  a  required  field  before  entering  necessary  informa¬ 
tion,  you  will  hear  a  beep. 


Special  Navigation  Methods 

You  move  from  column  to  column  by  pressing  «-*■.  You  move  up  and  down 

the  rows  with  f  and  J,.  Within  a  column,  you  move  left  or  right  with  «-  or 

You  can  leave  the  database  design  screen  by  choosing  an  option  from  the 

Exit  menu.  There  are  several  other  ways  to  leave  the  database  design  screen: 

■  You  can  press  when  the  cursor  is  inside  the  first  empty  Field  Name 
column  after  the  last  defined  field.  You  can  then  choose  to  input  new 
data  from  the  Browse/Edit  screen. 

■  You  can  press  Ctrl-W  or  Ctrl-End  from  anywhere  on  the  work  surface. 

You  can  then  choose  to  input  new  data  from  the  Browse/Edit  screen. 

■  You  can  press  Esc.  After  confirming  that  you  want  to  abandon  what  you 
were  doing,  you  will  return  to  where  you  came  from:  either  the  Control 
Center,  the  dot  prompt,  or  a  program.  If  you  do  not  confirm  that  you 
want  to  leave,  the  cursor  will  return  to  the  database  design  work  surface. 

■  You  can  press  F2  Data.  If  there  are  unsaved  changes  to  the  database  file 
structure,  you  will  hear  a  beep.  If  there  are  no  unsaved  changes  to  the 
structure,  the  Browse  or  Edit  screen  will  appear. 

■  You  can  press  Shift-F2  Design.  If  there  are  unsaved  changes  to  the  data¬ 
base  file  structure,  you  will  hear  a  beep  and  an  error  box  appears.  If 
there  are  no  unsaved  changes  to  the  structure,  the  queries  design  screen 
will  appear. 
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WARNING 

After  you  change  field  names,  always  save  the  modified  database 
structure  before  making  any  other  kind  of  changes,  such  as  to  field 
width  or  data  type. 


When  you  change  the  structure  of  a  database  file,  dBASE  IV  creates 
a  new  database  file  structure,  fills  it  with  data  from  the  old  structure, 
and  then  erases  the  old  structure.  dBASE  IV  knows  where  to  copy 
the  data  by  finding  either  the  names  of  the  fields  or  their  position  in 
the  database  file  structure. 


If  you  change  field  names  and  also  rearrange  their  positions  at  the 
same  time,  dBASE  IV  will  not  be  able  to  find  the  fields. 


Using  the  Database  Menu  Bar 

The  database  menu  bar  contains  five  menus:  Layout,  Organize,  Append,  Go 
To,  and  Exit.  The  menu  options  help  you  create  and  modify  a  database  file’s 
structure.  You  can  also  index  and  sort  records,  and  add  or  delete  records. 


The  Layout  Menu 


With  the  Layout  menu,  you  can 
print  the  structure  of  a  database 
file,  edit  its  description,  or  save  the 
structure  with  a  new  name. 


Print  Database  Structure 

This  option  prints  the  structure  of  the  current  database.  The  Print  menu  dis¬ 
plays,  and  you  can  modify  its  settings  before  printing  the  database  file  struc¬ 
ture.  For  more  information  about  the  Print  menu,  see  Chapter  5,  “Printing,” 
in  this  manual. 

Edit  Database  Description 

This  option  lets  you  modify  a  description  of  the  current  database  file.  The 
description  is  stored  in  the  current  catalog,  so  if  you  came  to  the  database 
design  screen  from  the  dot  prompt  and  there  is  no  catalog  in  use,  this  option 
will  be  dimmed  and  unavailable. 
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Save  this  Database  File  Structure 

Use  this  option  to  save  database  design  changes  as  you  go  along,  preventing 
data  loss  due  to  a  power  drop  or  other  electronic  problem.  You  can  also  use 
this  option  to  copy  the  current  database  file  by  saving  it  under  a  different 
name. 

After  you  choose  this  option,  accept  or  modify  the  suggested  name  for  the 
database  file  and  press  *-*■. 


The  Organize  Menu 


The  Organize  menu  helps  you 
work  directly  with  database  files. 
The  options  on  this  menu  are 
available  only  if  all  outstanding 
changes  to  the  database  structure 
have  been  saved.  You  cannot 
choose  one  of  these  options  with¬ 
out  first  saving  all  changes  to  the 
database  structure. 


Create  New  Index 

Use  this  option  to  create  an  index  for  a  database  file.  Any  index  you  create 
with  this  option  becomes  part  of  the  open  .mdx  file  associated  with  the  cur¬ 
rent  database  file.  The  .mdx  file  can  contain  up  to  47  sej^irate  indexes.  You 
can  even  have  additional  .mdx  files.  The  .mdx  file  with  the  same  name  as  the 
database  file  is  the  main  .mdx  file  and  is  called  th”e  production  .mdx 

After  you  press  the  menu  shown  in  Figure  6-2  appears. 
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Figure  6-2  The  create  index  submenu 


All  indexes  created  with  dBASE  IV  are  automatically  updated  in  special  files 
with  an  .mdx  extension.  There  is  at  least  one  .mdx  file  for  each  database  file. 
An  .mdx  file  can  be  considered  a  sort  of  library  of  indexes.  All  the  individual 
indexes  inside  the  .mdx  files  have  unique  names,  called  tags. 

Previous  versions  of  dBASE  required  separate  files,  with  .ndx  extensions,  for 
each  index. 

Name  of  Index 

Use  Name  of  index  to  assign  a  name  to  a  new  index.  Place  the  cursor  on 
this  option,  press  and  type  in  a  name.  Index  names  can  be  up  to  10  char¬ 
acters  long  and  follow  the  same  restrictions  as  field  names.  Press  •«-*■  to  finish 
the  entry. 

Index  Expression 

Index  expression  defines  the  expression  used  to  make  the  new  index. 

Enter  any  valid  dBASE  expression  such  as  Name+  C/ty-h  DTOS (Due date). 

You  can  get  assistance  with  this  option  by  pressing  Shift-FI  Pick  to  display  a 
list  of  possible  field  names  and  dBASE  operators  and  functions.  Use  F9  Zoom 
to  open  an  edit  box  if  you  need  more  room  to  enter  the  index  expression. 

Index  expressions  cannot  contain  the  names  of  logical  or  memo  fields. 

Order  of  Index 

You  can  use  the  Order  of  index  option  to  specify  whether  the  index  will  be 
in  ascending  order  (Aardvark  to  zebra )  or  descending  order  ( zebra  to  Aard- 
vark).  To  toggle  this  option  between  ASCENDING  and  DESCENDING,  press 

or  Spacebar. 
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When  dBASE  IV  makes  an  ascending  index,  upper-case  letters  come  before 
lower-case  letters.  Zebra  will  appear  before  aardvark.  When  dBASE  IV  makes 
a  descending  index,  upper-case  letters  come  after  lower-case  letters.  The 
word  aardvark  will  appear  before  Zebra. 

■N  TIP 

If  you  want  to  override  this  approach,  you  can  add  the  UPPER  or 
LOWER  /unctions  to  your  index  expression.  For  example,  you  could 
use  UPPER(Lname)  for  the  index  expression  if  you  want  an  ascending 
order  where  the  last  name  aardvark  appears  before  Zebra.  The  upper¬ 
case  conversion  applies  only  to  the  index.  The  data  will  still  appear  as 
you  entered  it. 

Display  First  Duplicate  Key  Only 

Sometimes  the  index  expression  for  several  records  contains  the  same  data. 
You  could  say  they  share  the  same  key,  just  as  different  locks  in  your  car  may 
open  with  the  same  key.  You  can  ask  dBASE  IV  to  include  in  the  index  only 
the  first  duplicate  record  it  finds  in  the  database  file. 

For  example,  suppose  you  make  an  index  on  Lastname  +  Address.  Some 
records  may  have  the  same  last  name  and  address.  As  far  as  the  key  is  con¬ 
cerned,  these  records  are  duplicates.  If  you  want  to  avoid  printing  labels  for 
John  Smith  and  Susie  Smith,  both  of  whom  live  at  the  same  address,  you 
could  ask  dBASE  IV  to  include  only  the  first  of  these  duplicates  in  the  index. 

To  do  this,  turn  the  Display  first  duplicate  key  only  option  to  YES.  In  the 
example  above,  when  you  print  labels  with  this  index  as  the  master  index, 
dBASE  IV  prints  a  label  for  either  John  Smith  or  Susie  Smith,  whichever 
record  is  in  the  index. 

You  can  read  more  about  this  in  the  entry  for  the  INDEX  ON  command  in 
Language  Reference.  This  option  is  equivalent  to  the  UNIQUE  keyword. 

When  you  finish  entering  information  in  this  menu,  press  Ctrl-End  to  save 
your  entry.  dBASE  IV  will  then  create  the  new  index. 

Modify  Existing  index 

Use  this  option  to  change  the  information  for  existing  dBASE  IV  indexes. 

When  you  choose  this  option,  a  list  of  the  current  index  names  appears  in 
the  upper  right  corner  of  your  screen.  A  box  next  to  the  list  of  names  dis¬ 
plays  the  index  expression  for  the  index  marked  by  the  cursor. 

You  can  move  the  cursor  up  and  down  the  list  until  you  find  the  index  you 
want  to  modify.  Press  and  the  menu  described  in  the  “Create  New  Index” 
section  appears.  Change  the  settings  and  press  Ctrl-End  to  save  your  changes. 

Order  Records  by  Index 

Only  one  index  at  a  time  can  be  the  master  index.  The  master  index  deter¬ 
mines  the  order  in  which  records  are  handled.  Use  the  Order  records  by 
index  option  to  tell  dBASE  IV  which  index  you  want  to  be  the  master. 
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open  .ndx  indexes.  Read  the  “Activate  NDX Index  File” section  below 
to  find  out  how  to  open  .ndx  indexes. 


NOTE 

dBASE  IV can  maintain  many  indexes  at  the  same  time.  It  automati¬ 
cally  updates  all  index  tans  in  the  current  .mdx  file,  as  well  as  anv 


When  you  select  this  option,  a  list  of  the  current  indexes  and  their  index 
expressions  appears.  If  you  have  added  to  the  current  catalog  older  .ndx 
index  files  from  a  previous  version  of  dBASE,  these  indexes  appear  with  their 
.ndx  extension.  Choose  the  index  you  want  to  be  the  master  index  and  press 


Activate  .NDX  Index  File 

Indexes  created  on  the  database  design  screen  are  updated  automatically  in 
.mdx  files.  Previous  versions  of  dBASE  required  separate  files,  with  .ndx 
extensions,  for  each  index. 

The  .ndx  files  created  with  earlier  versions  of  dBASE  can  be  used  by 
dBASE  IV,  but  the  improved  .mdx  files  are  unique  to  dBASE  IV  and  cannot 
be  used  by  earlier  versions  of  dBASE.  For  this  reason,  you  may  wish  to  have 
dBASE  IV  maintain  some  .ndx  files  if  you  plan  to  use  your  database  files  with 
earlier  versions  of  dBASE. 

In  order  to  keep  .ndx  files  up  to  date,  you  should  activate  them  before  mak¬ 
ing  changes  to  your  database  file.  For  example,  if  you  remove  a  record  from 
a  file,  that  change  will  be  reflected  in  the  .ndx  type  index  only  if  that  index 
has  been  activated. 

To  activate  .ndx  files,  choose  the  Activate  .NDX  index  file  option.  A  list 
appears  of  the  names  of  all  .ndx  files  that  belong  to  the  current  database  file. 
As  you  move  the  cursor  up  and  down  the  list,  each  index’s  expression 
appears.  Place  the  cursor  on  the  name  of  the  .ndx  file  you  want  to  activate 
and  press  •«->.  The  .ndx  file  is  now  activated,  and  will  reflect  changes  made  in 
the  database  file. 

You  may  have  a  total  of  10  .ndx  and  .mdx  files  open  at  one  time,  not  count¬ 
ing  the  production  .mdx  file. 


NOTE 

You  can  create  .ndx  files  from  the  dot  prompt  in  dBASE  IV.  Remem¬ 
ber,  however,  that  these  .ndx  indexes  must  be  opened  in  order  to  be 
updated  automatically. 


If  you  have  .ndx  Hies  that  were  not  open  when  changes  were  made  to 
the  database  file,  you  can  update  them  with  the  REINDEX  command 
from  the  dot  prompt. 
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Include  .NDX  Index  File 

The  Activate  .NDX  index  file  option  only  shows  those  .ndx  indexes  already 
in  the  current  catalog  that  belong  to  the  current  database  file.  To  add  a  new 
.ndx  index  to  the  current  catalog,  use  the  Include  .NDX  index  file  option. 

After  you  choose  this  option,  a  list  appears  of  all  the  .ndx  files  in  the  current 
directory.  Select  the  name  of  any  .ndx  file  that  belongs  to  the  current  data¬ 
base  file.  This  .ndx  file  will  then  appear  whenever  you  use  the  current  data¬ 
base  file  again  and  choose  the  Activate  .NDX  index  file  option. 

Remove  Unwanted  Index  Tag 

All  the  indexes  in  your  current  .mdx  file  are  maintained  automatically.  This 
maintenance  takes  some  time  for  each  index.  Whenever  there  are  indexes 
you  no  longer  need,  you  should  remove  them  from  your  .mdx  file  to  speed 
up  processing. 

When  you  select  this  option,  you  see  a  list  of  the  index  names  (called  tags! 
and  their  expressions.  Place  the  cursor  on  the  name  of  an  index  you  want  to 
delete  from  the  .mdx  file  and  press  «-»■.  That  index  will  be  removed  from  the 
.mdx  file. 


Sort  Database  on  Field  List 

This  option  lets  you  copy  data  from  the  current  database  file  into  a  new, 
sorted  database  file. 

After  you  select  this  item,  you  enter  the  names  of  fields  to  be  used  in  orga¬ 
nizing  the  sort.  Type  the  names  in  the  left  column  or  press  Shift-FI  Pick  for  a 
list  of  field  names  for  the  current  database  file.  You  may  select  up  to  ten  field 
names. 

To  eliminate  a  field  name  from  the  sort  list,  simply  place  the  cursor  over  that 
field’s  name  in  the  sort  list  and  press  Ctrl-U. 

The  top  field  name  in  the  sort  list  is  the  primary  key.  The  second  field  name 
in  the  list  is  the  secondary  key,  and  so  on. 

To  change  the  position  of  a  field  name  in  the  list,  place  the  highlight  on  the 
field  name  you  want  to  move  and  press  F7  Move.  Then  move  the  highlight. 
When  the  field  name  is  in  the  correct  position,  press  «-►. 

You  can  use  the  right-hand  column  to  request  one  of  four  types  of  sorting,  as 
shown  in  Table  6-1.  Press  Tab  and  Shift-Tab  to  move  between  the  left  and 
right  columns.  In  the  right  column,  press  Spacebar  to  cycle  through  the  four 
sorting  types. 
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Table  6-1  Sorting  types 


Name 

Ascending 
Descending 
Ascending  dictionary 
Descending  dictionary 


Example 

A.Za..z  0..9 
z..aZ..A  9..0 


Aa..Zz  0..9 


zZ.aA  9..0 


Dictionary  sorts  are  not  sensitive  to  case.  In  other  words,  if  you  choose 
Descending  dictionary,  all  the  words  beginning  with  the  letters  a  or  A 
appear  before  words  beginning  with  the  letters  b  or  B.  Words  are  used  as 
they  occur  in  the  database  file.  In  other  words,  whether  china  conies  before 
China  depends  on  which  word  occurs  first  in  the  database  file. 

When  you  finish  arranging  the  sort  list,  press  Ctrl-End.  You  can  also  press  *-*• 
when  the  cursor  is  in  an  empty  row  of  the  Field  order  column.  A  prompt 
appears  asking  for  a  name  to  give  the  new  sorted  file.  After  you  enter  the 
name,  the  sorting  begins.  The  original  file  remains  the  current  file. 

If  you  press  Esc  to  abandon  this  operation,  a  prompt  box  displays  to  make 
sure  you  want  to  leave  without  sorting. 

Unmark  All  Records 

If  you  have  marked  records  for  deletion  but  decide  to  keep  them,  use  this 
option  to  restore  those  records  to  the  database  file. 

After  selecting  this  option,  you  are  asked  to  confirm  your  intentions.  If  you 
repeat  that  you  want  to  unmark  the  records,  they  are  unmarked. 

Erase  Marked  Records 

Removing  records  from  a  database  file  is  a  two-step  process.  First,  records 
are  marked  for  deletion,  then  they  must  be  formally  removed  from  the  data¬ 
base.  This  safety  feature  make:  sure  that  only  the  records  you  really  want  to 
remove  are  taken  out  of  your  database  file. 

After  selecting  this  option,  you  are  asked  to  confirm  your  intentions.  If  you 
repeat  that  you  want  to  erase  the  marked  records,  they  are  erased. 

ompt  equivalent  command 
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The  Append  Menu 


You  can  use  the  Append  menu  to 
add  records  to  a  database  file. 
Although  you  use  the  Browse  or 
Edit  screens  to  add  records  field-by- 
field,  this  menu  also  lets  you  add 
groups  of  records  all  at  once.  Those 
records  may  come  from  dBASE  or 
non-dBASE  files. 

The  options  on  this  menu  are  available  only  if  all  outstanding  changes  to  the 
database  structure  have  been  saved.  You  cannot  choose  one  of  these  options 
without  first  saving  all  changes  to  the  database  structure. 

Enter  Records  from  Keyboard 

Use  this  option  to  add  new  records  field -by -field.  The  Edit  screens  appear 
and  the  record  number  is  positioned  at  the  end  of  the  file,  ready  to  add  a 
new  record. 


Dot  prompt  equivalent  command 
APPEND 


Append  Records  from  dBASE  File 

This  item  helps  you  add  records  from  one  dBASE  file  to  another.  When  you 
select  this  option,  a  list  of  dBASE  files  displays.  After  you  choose  a  file,  the 
records  in  the  file  are  added  to  the  records  in  the  current  database  file. 


Dot  prompt  equivalent  command 
APPEND  FROM 


Copy  Records  from  Non-dBASE  File 

Sometimes  you  have  useful  data  in  non-dBASE  IV  files.  This  option  lets  you 
bring  that  data  into  an  existing  dBASE  IV  file.  When  you  select  this  option,  a 
list  of  possible  file  types  displays.  You  can  then  pick  one  of  these  types. 

The  source  files  need  to  have  the  same  structure  as  the  file  you  want  to  hold 
the  data.  You  can  find  out  more  about  these  restrictions  in  the  APPEND 
FROM  entry  in  Language  Reference. 

When  you  choose  RapidFile,  dBASE  II,  Framework  II,  Lotus  1-2-3,  or 
VisiCalc  files,  the  file  list  shows  only  those  files  with  the  proper  extensions 
(.rpd,  .db2,  .fw2,  .wks,  .dif,  respectively). 

When  you  choose  Text  fixed-length  fields,  Blank  delimited,  or  Character 

delimited,  the  list  of  available  files  will  only  show  files  with  .txt  extensions. 
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When  you  choose  Text  ffxed^engtb  fields.  Blank  delimited,  or  Character 

If  you  want  to  use  information  from  properly  delimited  text  files,  rename 
them  with  a  .txt  extension  and  they  will  then  appear  in  the  list  of  choices. 

When  you  ask  to  append  from  MultiPlan  files,  you  will  see  all  the  files  that 
have  no  extensions.  You  will  not  see  any  files  that  obviously  belong  to  other 
applications  (.rpd,  ,db2,  .fw2,  .crd,  .dif,  .wks),  dBASE  IV  (.dbf,  .fmt,  .mdx),  or 
DOS  (.bat,  .ovl,  .exe). 

Qnote 

To  bring  in  data  from  the  newer  Lotus  1-2-3  files  with  .wkl  extensions, 
use  the  Import  option  on  the  Tools  menu.  You  can  find  this  menu  at 
the  Control  Center. 


Table  6-2  shows  the  equivalent  dot  prompt  commands  for  the  options  on  the 

Copy  records  from  non-dBASE  file  submenu. 

Table  6-2  Dot  prompt  commands  for  copying  data 


Submenu  option 

Type  of  file 

RapidFile 

database 

dBASE  II 

database 

Framework  II 

spreadsheet 
or  database 

Lotus  1-2-3 

spreadsheet 
(  wks  type) 

VisiCalc 

spreadsheet 

SYLK -MultiPlan 

spreadsheet 

Text  fixed-length 

text  (SDF) 

Blank  delimited 

text 

Character 

delimited 

text 

Dot  prompt  command 

APPEND  FROM  <  filename> 
TYPE  RPD 

APPEND  FROM  <  filename  > 
TYPE  DBASEII 

APPEND  FROM  <  filename  > 
TYPE  FWII 

APPEND  FROM  <  filename  > 
TYPE  WKS 

APPEND  FROM  <  filename  > 
TYPE  DIF 

APPEND  FROM  <  filename  > 
TYPE  SYLK 

APPEND  FROM  <  filename  > 
TYPE  SDF 

APPEND  FROM  <  filename  > 
DELIMITED  WITH  BLANK 

APPEND  FROM  <  filename  > 
DELIMITED  WITH  <  delimiter 
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The  Go  To  Menu 

With  the  Go  To  menu,  you  can 
quickly  reach  particular  fields  on  a 
database  design  screen. 

Top  Field 

This  option  moves  the  cursor  to  the  first  field  on  the  database  design  screen. 

Last  Field 

This  option  moves  the  cursor  to  the  last  field  on  the  database  design  screen. 

Reid  Number 

This  option  moves  the  cursor  to  the  field  with  the  number  you  specify. 

The  Exit  Menu 


With  the  Exit  menu,  you  can  leave 
the  database  design  screen. 


Save  Changes  and  Exit 

You  can  use  this  option  to  save  a  new  or  modified  database  structure. 

If  you  are  saving  a  new  database  structure  for  the  first  time,  you  will  be 
asked  to  name  it. 

If  you  have  been  modifying  an  existing  database  file,  you  see  different 
prompts.  If  there  is  any  data  in  the  existing  database  structure  and  you  have 
changed  the  name  of  a  field,  you  will  be  asked  if  you  want  to  copy  your  data 
from  the  existing  version  of  this  database  file  to  its  new  structure.  To  pre¬ 
serve  your  data  in  the  field  with  the  new  name,  choose  the  Yes  selection. 


It  is  best  to  save  the  database  structure  each  time  you  change  a  single 
Geld  name.  This  lets  you  specify  each  time  a  Geld  name  is  changed 
whether  to  copy  data  from  the  previous  Geld  or  start  over  with  no 
data. 


If  you  have  not  saved  your  changes  to  this  existing  database  structure,  a 
prompt  appears  asking  you  to  verify  that  you  want  to  save  your  changes. 

If  you  came  to  the  database  design  screen  from  the  Control  Center,  then  you 
will  return  to  the  Control  Center.  If  you  came  from  the  dot  prompt  or  a  pro¬ 
gram,  you  will  return  to  the  dot  prompt  or  program. 
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Abandon  Changes  and  Exit 

When  you  select  this  option,  a  prompt  appears  asking  you  to  verify  that  you 
want  to  abandon  your  changes. 

If  you  confirm  this  intention,  any  unsaved  changes  to  the  structure  of  the 
current  database  file  are  abandoned. 

If  you  came  to  the  database  design  screen  from  the  Control  Center,  you  will 
return  to  the  Control  Center.  If  you  came  from  the  dot  prompt  or  a  program, 
you  will  return  to  the  dot  prompt  or  program. 
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Designing 
Views  and 
Queries 


Introduction  to  View  Queries  and  Update  Queries 

The  queries  design  screen  has  unique  tools  to  help  you  retrieve,  organize, 
edit,  and  display  data. 

You  can  use  the  queries  design  screen  to  create  view  queries  ox  update  que¬ 
ries.  A  view  query  contains  instructions  on  how  to  create  special  data  files 
called  views.  An  update  query  contains  instructions  on  how  to  edit  many 
records  at  a  time.  You  can  save  a  view  query  or  an  update  query  to  use  it 
again. 

Although  view  queries  and  update  queries  use  the  same  queries  design 
screen,  they  do  two  different  tasks.  View  queries  define  views,  which  custom¬ 
ize  the  data  that  appears  on  the  screen  or  printer.  Update  queries  define  a  set 
of  operations,  which  directly  change  the  data  in  your  database  files. 


Views 


Views  let  you  select  certain  records,  display  only  specified  fields,  and  com¬ 
bine  the  data  from  several  database  files.  Views  are  assembled  in  your  com¬ 
puter’s  RAM  memory,  which  is  faster  than  its  hard  disk  or  floppy  disk  drives. 
When  you  are  through  using  a  view,  it  disappears. 

With  views,  you  are  free  to  manipulate  your  data  without  using  a  lot  of  disk 
space  or  trying  to  keep  duplicate  copies  of  data  up  to  date.  Since  you  can 
store  the  query  that  defines  a  view,  you  can  always  re-create  a  view  by  bring¬ 
ing  back  the  query  that  created  it. 

When  you  design  a  view  query,  you  create  a  description  of  how  to  display 
your  data.  After  you  select  the  view  query  and  then  BROWSE  or  EDIT  it,  you 
see  the  data  according  to  the  design  of  the  view  query.  It  will  seem  as  if  you 
had  many  database  files,  each  designed  for  particular  purposes. 

Views  can  also  furnish  the  data  for  reports  and  labels.  When  you  use  a  view 
to  supply  the  data  to  a  report  or  label,  you  have  control  over  which  records 
will  be  printed.  You  can  also  link  different  database  files  to  use  their  com¬ 
bined  data  in  reports  and  labels. 

When  you  want  to  activate  an  existing  view,  choose  it  from  the  Control  Cen¬ 
ter’s  Queries  panel,  or  type  SET  VIEW  TO  <  viewname>  from  the  dot 
prompt. 
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Updates 


Update  queries  let  you  change  selected  fields  and  records,  giving  you  a  fast 
and  powerful  way  to  modify  your  data.  Each  update  query  modifies  a  single 
and  specific  database  file. 

Update  queries  can  use  one  of  four  operations:  Append,  Mark,  Replace,  or 
Unmark.  These  operations  are  similar  to  the  dBASE  commands  APPEND, 
DELETE,  REPLACE,  and  RECALL.  You  can  read  more  about  these 
commands  in  Language  Reference. 

Typical  Uses  of  Update  Queries 

Typical  uses  of  each  of  these  operations  are  given  in  the  following  list. 

■  Append:  Add  all  the  new  hires  to  the  credit  union  membership  list. 

■  Mark:  Remove  all  paid-up  clients  from  the  overdue  list. 

■  Replace:  Add  10%  to  the  price  of  all  red  parts. 

■  Unmark:  Reinstate  previously  sold-out  parts  to  the  availability  list. 

After  You  Create  an  Update  Query 

When  you  create  an  update  query,  nothing  happens  to  your  data  until  you 
perform  the  query.  This  means  you  can  leave  the  queries  design  screen  by 
saving  an  update  query  and  then  return  to  the  Control  Center.  The  update 
query  is  still  available  for  use  in  the  future. 

When  you  perform  an  update  query,  either  from  the  queries  design  screen  or 
the  Control  Center,  the  operation  specified  in  the  update  query  is  carried 
out.  You  can  then  press  F2  Data  to  see  the  changed  database  file  on  the 
screen  and  evaluate  the  result  of  the  update. 

When  you  want  to  perform  an  existing  update  from  the  dot  prompt,  type 
DO  <  updatename>  .upd  or  DO  <  updatename>  .upo.  Because  the  DO 
command  normally  looks  for  a  program  file,  it  is  necessary  to  enter  the  .upd 
or  .upo  extension. 


Using  the  Queries  Design  Work  Surface 

You  can  reach  the  queries  design  screen  in  several  ways: 

■  From  the  dot  prompt,  enter  CREATE  VIEW  <  filename  >  or  MODIFY 
VIEW  <  filename >  . 

■  From  the  dot  prompt,  enter  CREATE  QUERY  <  filename  >  or  MODIFY 
QUERY  <  filename  >  . 

■  From  the  Control  Center,  place  the  cursor  on  the  <  create >  marker  in 
the  Queries  panel  and  press  ^  or  Shift-F2  Design. 

■  From  the  Control  Center,  place  the  cursor  on  the  name  of  an  existing 
query  and  press  Shift-F2  Design. 
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■  From  the  Control  Center,  if  SET  INSTRUCT  is  ON,  place  the  cursor  on 
the  name  of  an  existing  query  and  press  Then  select  the  Modify 
query  choice  from  the  panel  prompt  box. 

■  From  the  Browse  or  Edit  screens,  press  Shift-F2  Designor  choose  the 
Transfer  fo  Query  Design  option  from  the  Exit  menu. 

■  From  the  design  screens  for  database  files,  forms,  reports,  or  labels, 
press  Shift-F2  Design. 

On  the  queries  design  screen,  you  use  a  graphic  interface  to  create  both  view 

queries  and  update  queries.  Figure  7-1  shows  a  typical  view  query. 


Figure  7-1  The  queries  design  work  surface 

The  approach  used  by  dBASE  IV  on  the  queries  design  screen  is  a  QBE  inter¬ 
face.  The  letters  QBE  stand  for  query  by  example.  This  version  of  QBE  was 
developed  just  for  dBASE  IV. 

File  skeletons  provide  places  to  write  instructions  about  particular  fields.  At 
the  bottom  of  the  screen  is  another  skeleton.  This  is  the  view  skeleton,  which 
represents  the  fields  that  will  be  in  the  view  created  by  the  view  query. 

The  file  skeletons  are  a  model  of  the  database  input  to  the  query  design  pro¬ 
cess,  while  the  view  skeleton  represents  the  output. 

A  third  type  of  skeleton  on  the  queries  design  screen,  the  calculated  field 
skeleton,  shows  any  calculated  fields  created  for  the  current  view. 

The  fourth  element  of  the  queries  design  work  surface  is  the  optional  condi¬ 
tion  box,  which  makes  it  easy  to  enter  complicated  filter  conditions  that 
involve  several  fields.  Only  the  records  satisfying  these  conditions  are 
allowed  into  the  view. 
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NOTE 

Query  files  are  saved  on  your  disk  with  a  .qbe  extension.  Update  que¬ 
ries  receive  a  .upd  extension. 


Special  Navigation  Methods 

You  can  move  up  or  down  between  the  skeletons  and  condition  box  by 

pressing  F3  Previous  or  F4  Next. 

To  move  within  a  column,  press  *-  or  To  move  to  the  next  or  previous 
column,  press  Tab  or  Shift-Tab.  You  can  move  quickly  to  the  far  right  or  far 
left  columns  by  pressing  End  or  Home.  The  name  of  the  file  remains  in  the 
left  column  when  you  scroll  the  other  columns. 

If  you  want  to  move  up  or  down  the  rows  of  a  file  skeleton,  press  f  or  i.  You 
can  move  quickly  to  the  top  or  bottom  of  a  file  skeleton  column  by  pressing 

Ctrl-PgUp  or  Ctrl-PgDn. 

If  you  have  more  file  skeletons  than  will  fit  on  one  page  of  the  screen,  you 
can  move  to  the  next  or  previous  page  of  file  skeletons  by  pressing  PgDn  or 
PgUp  When  there  are  file  skeletons  below  the  ones  currently  displayed,  a 
small  arrow  appears  in  the  lower  left  portion  of  the  screen. 


File  Skeletons 

A  file  skeleton  is  a  visual  representation  of  the  structure  of  a  database  file. 

File  skeletons  appear  at  the  top  of  the  work  surface.  Views  can  handle  more 
than  one  file,  so  you  may  place  up  to  eight  file  skeletons  on  the  queries 
design  screen. 

In  Figure  7-1,  the  first  file  is  named  Employee.dbf.  The  name  of  the  file 
appears  at  the  left  of  the  skeleton.  The  fields  in  the  file  appear  as  column 
names  to  the  right  of  the  filename. 

If  a  file  has  more  fields  than  will  fit  across  the  screen  at  one  time,  press  Tab 
until  the  other  fields  scroll  into  view.  Press  Shift-Tab  to  move  the  cursor  back 
the  other  way. 


The  View  Skeleton 

Every  view  query  produces  one  view,  so  there  is  only  one  view  skeleton  per 
view  query.  Since  an  update  query  does  not  produce  a  view,  it  has  no  view 
skeleton. 

The  view  skeleton  is  a  visual  representation  of  the  fields  in  the  view  created 
when  the  view  query  is  performed.  The  name  of  the  view  appears  on  the  left 
of  the  skeleton,  while  the  other  boxes  show  the  names  of  those  fields  chosen 
to  be  in  the  view. 

The  view  skeleton  shows  only  the  fields  you  have  requested  for  the  view. 
Working  with  a  field  on  the  queries  design  surface  does  not  obligate  you  to 
show  that  field  in  the  resulting  view.  You  could,  for  example,  use  a  salary 
field  to  filter  records  without  putting  the  salary  field  in  the  view. 
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Adding  Fields  to  a  View 

To  add  a  field  to  the  view,  position  the  cursor  in  the  field’s  column  of  the 
database  file  skeleton  or  calculated  field  skeleton.  Then  press  F5  Field  or 
select  the  Add  field  to  view  option  from  the  Fields  menu. 

An  image  of  the  field  you  have  chosen  is  placed  in  the  view  skeleton  to  join 
the  other  fields  selected  for  the  view.  If  you  are  adding  a  calculated  field,  a 
prompt  will  ask  for  a  name  if  the  field  does  not  already  have  one. 

You  can  also  add  many  fields  at  once  by  placing  the  cursor  under  the  name 
of  a  file  skeleton.  If  the  file  has  no  fields  in  the  view,  all  its  fields  will  be 
placed  in  the  view  when  you  press  F5  Field.  If  the  file  already  has  some  fields 
in  the  view,  the  rest  of  the  fields  will  be  added  to  the  view  when  you  press 

F5  Field 

If  the  file  already  has  all  its  fields  in  the  view,  pressing  F5  Field  will  remove 
all  its  fields  from  the  view. 

Fields  are  placed  in  the  view  skeleton  from  left  to  right,  in  the  order  they  are 
added  to  the  view.  To  change  this  order,  select  a  field  in  the  view  skeleton  by 
pressing  F6  Extend  Select.  You  may  select  one  or  more  fields  next  to  this 
field  by  pressing  Tab  or  Shift-Tab. 

When  you  have  selected  the  fields  you  want  to  move,  press  «*->.  Then  press 
F7  Move  followed  by  *-  or  -*  to  move  the  field  (or  fields)  where  you  want 
them  in  the  view  skeleton.  Press  «-*•  to  complete  the  move. 


WARNING 

The  field  names  in  the  query  become  the  column  headings  for  the 
resulting  view’s  Browse  screen.  All  the  field  names  in  the  view  skele¬ 
ton,  therefore,  must  be  unique. 


Suppose  you  have  two  different  file  skeletons  in  a  query  and  these 
files  share  a  common  field  name.  To  include  both  fields  in  the  view 
skeleton,  use  the  Edit  field  name  option  from  the  Fields  menu  to 
give  one  of  the  fields  a  unique  name  in  the  view  skeleton. 


Removing  Fields  from  a  View 

You  can  remove  a  field  from  the  view  skeleton  by  placing  the  cursor  either 
under  the  field’s  name  in  the  file  skeleton,  or  over  the  field’s  name  in  the 
view  skeleton. 

Once  the  cursor  marks  the  field  you  want  to  remove  from  the  view  skeleton, 
either  press  F5  Field  or  choose  the  Remove  field  from  view  option  from  the 
Fields  menu.  The  image  of  the  field  you  have  chosen  disappears  from  the 
view  skeleton. 

You  can  also  use  a  special  technique  to  remove  many  fields  at  once.  Place 
the  cursor  under  the  name  of  a  file  skeleton.  If  all  the  file’s  fields  are  already 
in  the  view  skeleton,  they  will  be  removed  from  the  view  skeleton  when  you 
press  F5  Field. 
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(If  all  the  fields  from  this  file  are  not  in  the  view,  they  will  first  be  added  to 
the  view.  Then  you  can  press  F5  Field  again  to  remove  them  all  from  the 
view.) 


Entering  Filter  Conditions 

Enter  conditions  and  other  instructions  about  fields  in  the  space  beneath  a 
field  name.  For  example,  entering  the  condition  "Glendale"  in  the  City  col¬ 
umn  acts  as  a  filter.  Only  records  where  the  city  is  Glendale  will  be  shown  in 
the  view. 

The  conditions  can  be  any  valid  dBASE  expressions,  as  well  as  the  special 
operators  described  in  this  chapter.  You  can  use  the  relational  operators  in 
Table  7-1. 

To  enter  a  logical  condition,  simply  enter  .T.  or  .F.  in  the  column  of  a  logical 
field.  (You  can  also  enter  .t.,  .f.,  .  Y,  .N.,  .y.,  or  .n..) 

As  you  type  into  a  skeleton’s  column,  the  condition  scrolls  when  you  reach 
the  right  border  of  the  column.  You  can  press  F9  Zoom  to  zoom  the  column 
larger  and  see  a  long  condition  in  its  entirety.  Press  F9  ZOOM  again  to  shrink 
the  column  back  to  its  original  size. 

Specific  text  should  be  surrounded  by  quotation  marks,  just  as  it  is  in  other 
dBASE  expressions.  You  may  also  use  the  built-in  arithmetic  functions:  +  , 

—  **,  or  A.  You  can  also  use  the  dBASE  IV  functions  such  as  time(), 

date(),  and  recpno().  You  can  choose  from  a  list  of  functions,  operators,  and 
field  names  by^ressing  Shift-FI  Pick. 


Table  7-1  Relational  operators 


Operator 

Description 

> 

greater  than 

< 

less  than 

= 

equal 

<  >  or  # 

not  equal 

>  = 

greater  than  or  equal 

<  = 

less  than  or  equal 

$ 

contains 

Like 

pattern  match 

Sounds  like 

Soundex  match 

On  the  queries  design  screen,  the  syntax  for  the  $  operator  is  different  from 
the  rest  of  dBASE  IV.  The  quoted  string  to  be  used  as  the  search  substring  is 
placed  after  the  operator  rather  than  before.  For  example,  to  display  only  the 
records  for  Western  Regional  Sales,  enter  $  "  Western  Regional  Sales"  in  the 
relevant  column. 
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The  operator  Like  is  followed  by  the  search  string  you  want  to  find.  The 
string  should  be  in  quotes,  and  it  can  include  wildcards  (*  and  ?).  To  find  all 
the  cities  beginning  with  the  word  New,  for  example,  you  could  enter  Like 
" New *"  in  the  City  column.  This  would  find  New  Haven,  New  London,  New 
York,  and  so  on. 

The  operator  Sounds  like  is  followed  by  a  quoted  character  string.  A 
Soundex  code  is  a  mathematical  way  to  describe  how  a  word  sounds.  The 
Sounds-like  operator  only  permits  words  with  Soundex  codes  matching  the 
quoted  character  string.  For  example,  to  find  all  the  people  named  Ann  or 
Anne,  you  could  enter  Sounds  like  "ann "  under  the  Firstname  field. 

See  Language  Reference  to  read  more  about  the  relational  operators  shown 
in  Thble  7-1.  That  book  also  tells  more  about  the  Like  and  Sounds  like  opera¬ 
tors  in  the  sections  about  the  LIKEQ,  DIFFERENCEQ,  and  SOUNDEXQ 
functions. 


Combining  Conditions 

The  queries  design  surface  provides  two  ways  to  combine  conditions. 

If  you  place  two  or  more  conditions  in  the  same  row  of  a  file  skeleton,  ALL 
the  conditions  must  be  met  for  a  record  to  be  included  in  the  view  or 
update. 


Layout  Fields  Condition  Update  Exit 
| Employee. dbf |  SALARY  I  TITLE 

|  >  50000 


■Uleu - .  ■  | 

IjUnt  i  tied  |Enployee-> 

Ulastname 

FIRSTNAME 

Employee- > 
INITIAL 

Employee-* 

DEPARTMENT 

Next/Prev  field: Tab/Shift-Tal 

>  Data: FZ  Pick 

:  Shift-Fl  Prev/Next  skel  =  FVF4 

Figure  7-2  A  query  in  which  both  conditions  must  be  met 
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If  you  place  two  or  more  conditions  in  different  rows  of  a  file  skeleton,  only 
ONE  of  the  conditions  must  be  met  for  a  record  to  be  included  in  the  view 
or  update. 


Figure  7-3  A  query  in  which  only  one  condition  must  be  met 

The  view  query  in  Figure  7-2,  for  example,  will  display  employees  who  earn 
$50,000  and  have  over  four  years  of  experience.  The  conditions  in  Figure  7-3 
ask  to  see  employees  who  either  make  a  certain  salary  or  have  over  four 
years  of  experience. 

You  can  also  require  two  conditions  on  the  same  field.  This  is  useful  for 
selecting  data  within  a  range  of  values.  For  example,  in  Figure  7-3,  if  you 
entered  the  condition  in  the  Salary  field  as  >  50000,  <  60000 ,  this  would 
select  employees  who  earn  between  $50,000  and  $60,000. 


Using  a  Condition  Box 

The  condition  box  is  optiona1  and  appears  in  the  lower  right  corner  of  the 
screen.  Use  the  condition  box  to  enter  a  filter  that  applies  to  every  record 
and  database  file  on  the  queries  design  screen. 

For  example,  the  condition  box  in  Figure  7-1  requires  that  the  view  show 
only  those  salespeople  in  commercial  sales  who  live  in  Arizona  and  have 
three  or  more  years  of  experience. 

If  you  need  more  room  to  edit  a  condition,  you  may  use  F9  Zoom  to  expand 
the  condition  box  to  fill  the  screen.  You  can  also  use  the  Show  condition 
box  option  on  the  Condition  menu  to  display  or  hide  the  condition  box. 

This  is  useful  when  you  have  several  file  skeletons  on  the  screen  and  would 
like  to  have  the  condition  box  out  of  the  way.  Whenever  you  move  the  cur¬ 
sor  to  a  closed  condition  box  with  F3  Previous  or  F4  Next,  the  condition  box 
opens. 
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Creating  Calculated  Fields 

The  calculated  field  skeleton  is  optional.  If  you  have  any  calculated  fields 
created  for  this  view,  the  calculated  field  skeleton  appears  just  above  the 
condition  box.  It  looks  like  a  file  skeleton,  and  always  has  the  name  Calc’d 
Fid*-  You  may  create  up  to  20  calculated  fields  for  each  query. 

You  may  enter  valid  dBASE  expressions  inside  the  headings  of  the  calculated 
field  skeleton.  When  the  query  builds  a  view,  the  value  of  each  calculated 
field  is  computed.  These  computed  values  can  then  be  used  like  the  stored 
values  from  the  database  files. 

For  example,  if  you  want  a  field  in  a  view  to  show  the  tax  on  every  part  sold, 
you  could  make  a  calculated  field  called  Tbx,  consisting  of  the  expression 
price  *  taxrate.  By  including  this  calculated  field  in  the  view  skeleton,  you 
would  see  the  tax  for  each  part  in  the  view. 


Sorting  a  Query’s  Records 

Data  is  often  more  convenient  to  access  when  displayed  in  alphabetical  or 
numerical  order.  You  can  do  this  with  the  records  in  your  views  by  using 
sorting  operators. 

There  are  four  sorting  operators:  ascending ,  descending,  ascending  diction¬ 
ary,  and  descending  dictionary.  An  ascending  sort  starts  from  the  beginning 
of  the  alphabet  or  from  the  smallest  number.  A  descending  sort  starts  from 
the  end  of  the  alphabet  or  from  the  largest  number. 


Figure  7-4  An  ascending  sort 


In  the  basic  ascending  sort,  all  upper-case  letters  are  handled  before  lower¬ 
case  letters.  For  example,  in  Figure  7-4,  Zebra  comes  before  aardvark.  This 
type  of  sorting  is  also  called  an  ASCII  sort. 
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In  the  ascending  dictionary  sort,  it  doesn’t  matter  whether  the  letters  are 
upper  case  or  lower  case.  In  Figure  7-5,  the  words  aardvark  and  Aardvark 
come  before  zebra  and  Zebra. 


Figure  7-5  An  ascending  dictionary  sort 


In  an  ascending  dictionary  sort,  when  words  have  the  same  spelling  but  dif¬ 
ferent  capitalization,  they  are  handled  according  to  their  position  in  the  data¬ 
base  file.  For  example,  if  turkey  is  in  Record  2  and  Turkey  is  in  Record  3, 
turkey  will  come  before  Turkey. 


You  can  enter  a  sorting  operator  by  typing  it  directly  into  a  file  skeleton.  You 
can  also  choose  the  Sort  on  this  field  option  from  the  Fields  menu.  You 
cannot  use  a  sorting  operator  on  a  calculated  field  or  inside  a  condition  box. 

Sorting  on  Several  Reids 

There  may  be  times  when  you  want  to  sort  a  view’s  records  on  several  fields. 
You  can  do  this  by  entering  more  than  one  sorting  operator. 

For  example,  suppose  you  want  to  organize  a  view’s  records  by  state,  and 
then  see  them  further  organized  within  each  state  alphabetically  by  city. 
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Figure  7-6  A  query  with  two  sort  operators 


The  sorting  operators  are  given  priority  according  to  optional  numbers 
added  after  the  sorting  operators.  If  you  don’t  specify  any,  the  sorting  prior¬ 
ity  is  assigned  from  left  to  right. 

In  Figure  7-6,  the  STATE  column  contains  Ascl  and  the  CITY  column  con¬ 
tains  Asc2.  This  means  that  the  primary  sorting  will  be  done  by  state,  and 
within  each  state  the  records  will  be  further  sorted  by  city.  The  resulting 
view  is  shown  in  Figure  7-7. 


Records  Fields  Go 

To  Exit 

LASTNAME 

FIRSTNAME 

ADDRESS 

CITY 

STATE 

ZIP 

PHO 

Hank 

4101  Peonia  Rd 

Flagstaff 

AZ 

86001 

<60 

Ulcky 

203  E.  3rd  St.  S. 

Mesa 

AZ 

85Z01 

(60 

Canpbell 

6700  Tyler  St. 

Paragould 

AZ 

86334 

(60 

Dickerson 

Lori 

14565  Collins  Ave. 

Phoenix 

AZ 

85041 

(60 

Hanllton 

6406  Shirley  Ave. 

AZ 

85743 

(60 

Long 

Chuck 

40677  Misty  Isle  Dr. 

AZ 

85745 

(60 

Sandy 

440  Chevy  Chase  Blud 

Beverly  Hills 

CA 

30213 

<Z1 

Marilyn 

6045  Ulneland  Blvd. 

Hollyuood 

CA 

300Z8 

(21 

Keegan 

Keith 

6045  Ulneland  Blvd. 

Hollyuood 

CA 

30028 

<Z1 

Peters 

10711  Highland  Ave. 

Los  Angeles 

CA 

30044 

<Z1 

Egan 

Michelle 

5670  Colorado  Blvd. 

Denver 

CO 

80Z43 

(30 

Drasln 

12804  Sunburst  Ave. 

Hartford 

CT 

06103 

(20 

Rizzo 

20384  Capitol  Ave. 

Uashlngton 

DC 

20002 

(Z0 

Gilbert 

Chuck 

7613  0  Street 

Uashlngton 

DC 

Z000Z 

<Z0 

Orlando 

833  Galleon  St. 

N.  Bay  Ulllage 

FL 

33141 

<30 

7010  Balcon  Ave. 

Marietta 

GA 

30066 

(40 

Zanblni 

Rick 

108  Prairie 

Idaho  Falls 

ID 

83403 

<20 

Figure  7-7  A  view  sorted  on  two  fields 
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Summarizing  Records 

You  may  want  to  summarize  the  values  in  certain  fields  and  then  display  the 
results  in  a  view.  You  can  do  this  with  summary  operators ,  which  apply  arith¬ 
metic  operations  to  the  records  in  a  database  file.  These  operators  are  also 
referred  to  as  aggregate  operator 

You  can  ask  dBASE  IV  to  find  the  sum,  minimum,  maximum,  or  count  of 
a  collection  of  records.  To  include  a  summary  operation  in  a  query,  enter 
the  abbreviations  SUM,  AVG,  MIN,  MAX,  or  CNT in  the  column  of  the  field 
to  which  you  want  it  applied.  (You  can  also  use  the  words  COUNT  and 
AVERAGE  instead  of  CATand  AVG.) 

For  example,  to  find  the  average  salary  of  a  group  of  employees,  place  the 
abbreviation  AVG  under  the  name  of  the  field  that  contains  salaries. 


Layout  Fields  Condition 

Update  Exit 

■B332E2M3& 

| Employee, dbf | i SALARY 

| iTITLE 

|  *VRS. 

.EXPEH 

|Aug 

■■■» 

lawgsum  Employee- > 

Employee- > 

Efipl  o  y  ee —  > 

Employee-> 

Hlastname 

SALARY 

TITLE 

YRS.EXPER 

Next'Prev  field:  Tab/Shift-Tab  Data: F2  Pick:  Shlft-Fl  Prev^Next  skel:FVF4 

Figure  7-8  A  query  with  two  summary  operators 


Summary  operators  can  only  be  used  with  certain  fields,  as  shown  in  Table 
7-2.  Summary  operators  are  not  allowed  in  update  queries  and  cannot  be 
combined  with  the  FIND  operator. 


Table  7-2  Summary  operators  for  each  type  of  field 


Type  of  field 

Summary  operator 

Numeric 

AVG,  SUM,  MIN,  MAX,  CNT 

Float 

AVG,  SUM,  MIN,  MAX,  CNT 

Character 

MIN,  MAX,  COUNT 

Date 

MIN,  MAX,  COUNT 

Logical 

COUNT 

Memo 

(none  available) 
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When  you  enter  a  SUM,  AVG,  CNT,  MIN,  or  MAX  operator  in  a  field’s  col¬ 
umn,  you  are  telling  dBASE  IV  to  show  the  relevant  value  of  that  field  in  the 
resulting  view.  All  other  fields  in  the  view  will  usually  be  blank. 


Records  Fluid*  G< 

>  To  Exit 

4-10.Z3  pn 

LASTNAME 

SALARY 

TITLE 

YRS EXPER 

Z4ZS7 

175 

B rouse  |Ci\dbase\saMples\AUGSUW  |Rec  1/1 

I1"™  |  | 

Figure  7-0  A  view  made  with  two  summary  operators 


Figure  7-9  shows  the  average  salary  and  the  total  number  of  years  of  experi¬ 
ence  for  ell  employees  in  Employee. dbf.  The  other  fields  besides  Salary  and 
Yrs_exper  are  blank. 


NOTE 

When  dBASE  IV  performs  a  query,  it  goes  through  one  of  the  database 
files  one  record  at  a  time,  looking  for  matches  with  records  in  the 
other  files,  filtering  records  to  meet  specified  conditions,  and  perform¬ 
ing  summary  calculations. 


Therefore,  when  you  enter  summary  operators,  you  cannot  filter 
records  by  a  condition  that  would  depend  on  going  through  all  the 
records  first.  For  example,  you  cannot  filter  out  all  the  records  of 
employees  who  earn  less  than  the  average  salary,  since  the  average 
salary  would  only  be  known  after  the  records  have  been  processed. 
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Grouping  Records 

There  may  be  times  when  you  want  to  apply  summary  operators  to  records 
that  have  been  organized  into  groups,  perhaps  by  department  or  by  city. 

You  can  apply  summary  operators  to  groups  of  records  with  the  Group  By 
operator. 

The  Group  By  operator  organizes  the  records  into  groups  which  all  contain 
the  same  value  for  some  field.  Then  the  summary  operators  are  applied  to 
the  values  in  each  group  of  records. 


Figure  7-10,  for  example,  shows  a  view  query  with  a  Group  By  operator  in 
the  Title  field.  This  view  shows  the  results  of  summary  operators  applied  to 
groups  of  employees.  There  is  a  different  group  for  each  distinct  value  in  the 
Title  field.  Figure  7-11  shows  the  resulting  view. 
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Figure  7-1 1  A  view  made  by  a  query  with  a  Group  By  operator 


The  numbers  in  the  Salary  column  show  the  average  salary  for  each  type  of 
worker.  The  numbers  in  the  Yrs_exper  column  show  the  total  years  ofexpe 
rience  for  all  the  workers  of  each  type.  There  are  four  managers,  who  have 
4,  7,  9,  and  3  years  experience,  for  example.  Between  them,  therefore,  they 
have  a  total  of  23  years  of  experience. 


NOTE 

The  Group  By  operator  is  designed  to  work  with  summary  operators. 
If  you  simply  want  to  organize  the  records  in  a  view  without  per¬ 
forming  any  summary  calculations,  you  can  do  this  with  the  sorting 
operators. 


When  you  use  groups,  all  the  fields  in  the  view  contain  data.  This  is  a  little 
different  from  the  summary  operators,  which  only  show  data  in  fields  that 
have  a  summary  operator  in  the  file  skeleton.  In  Figure  7-11,  for  example, 
the  view  shows  data  for  each  field  in  the  view,  even  though  the  summary 
operators  are  only  in  the  Salary  and  Yrs_exper  fields. 

The  Values  in  Non-Summary  Fields 

When  you  use  a  Group  By  operator  and  the  CNT,  AVG,  and  SUM  operators, 
the  data  in  non-summary  fields  has  no  special  connection  to  the  summary 
values.  They  are  simply  the  records  that  occur  last  in  each  group  when 
dBASE  IV  forms  the  groups. 

For  example,  in  Figure  7-11,  Lena  Garnett  does  not  have  a  salary  of  $1 1,563, 
nor  13  years  of  experience.  The  $11,563  salary  value  represents  the  average 
salary  for  all  clerks,  and  the  13  years  in  the  Experience  column  is  the  total 
years  of  experience  for  all  the  clerks. 
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When  you  use  the  MIN  or  MAX  operator  with  a  Group  By  operator,  how¬ 
ever,  the  data  in  the  non-summary  fields  is  appropriate  to  the  values  in  the 
MIN  or  MAX  field.  The  information  in  non-summary  fields  is  taken  from  the 
record  that  has  the  minimum  or  maximum  value  in  the  summarized  field. 


Figure  7-12  A  query  with  a  MIN  and  Group  By  operator 


For  example,  in  Figure  7-12,  the  MIN  operator  is  used  on  the  Salary  field. 
The  resulting  view  in  Figure  7-13  shows  that  Harry  Eivera  has  the  minimum 
clerk’s  salary  of  $10,500. 


Figure  7-13  A  view  made  from  a  query  with  a  MIN  and  Group  By  operator 
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Ordering  the  Groups 

In  Figure  7-13,  the  values  in  the  Title  field  are  shown  in  ascending  order, 
from  Clerk  to  Vice  President.  This  is  because  when  you  use  the  Group  By 
operator,  dBASE  IV  automatically  performs  an  ascending  sort  on  the  values 
in  that  field. 

If  you  want  to  sort  the  groups  differently,  you  can  include  a  different  sorting 
operator  after  the  Group  By  operator,  separated  by  a  comma.  The  groups 
will  then  appear  in  the  order  you  specify.  If  you  enter  Group  by,  Dsc  in  the 
Title  column,  the  view  displays  the  groups  in  descending  order,  from  Vice 
President  to  Clerk. 

If  Group  By  operators  appear  in  more  than  one  column,  the  records  are 
grouped  according  to  the  priorities  assigned  by  the  optional  sorting  opera¬ 
tors.  If  you  have  one  column  with  a  Group  By  operator  and  another  column 
with  a  sorting  operator,  the  Group  By  operator  is  applied  first.  The  single 
sorting  operator  is  applied  only  after  the  records  have  been  filtered  and 
grouped. 
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Figure  7-1 4  A  query  with  Group  By  and  sorting  operators 


In  Figure  7-14,  for  example,  the  Specialty  field  will  be  sorted  only  after  the 
groups  are  formed.  Because  the  Phone_emp  field  has  an  explicit  sorting  pri¬ 
ority,  it  will  be  given  a  higher  sorting  priority  than  the  Empid  field. 


USING  THE  MENU  SYSTEM 


7-17 


JOBNAME:  PAGE:  18  SESS:  5  Tue  Hay  17  17:  1A:  20  1988 

@tate/d  i  sk2/a l l j  obz/CLS_manhat/GRP_manhat/J0B_manusemen/DIV_umchap7 

Ignoring  Duplicate  Values 

When  you  use  summary  operators,  there  may  be  times  when  you  want  to 
ignore  field  values  identical  to  each  other.  You  can  do  this  by  adding  the 
word  unique  after  the  SUM,  AVG,  or  CNT  operators. 

For  example,  suppose  you  want  to  know  how  many  different  first  names  are 
in  Employees.dbf.  If  you  enter  the  abbreviation  CATin  the  Firstname  field, 
you  get  a  count  of  how  many  people  have  first  names  (47).  To  see  how  many 
distinct  first  names  are  in  the  database  file,  enter  CNT  UNIQUE.  Now  the 
view  query  will  show  there  are  38  different  first  names  in  Employee.dbf. 


NOTE 

When  you  use  Unique,  you  cannot  have  another  summary  operator 
on  the  queries  design  screen. 


( 7r 


Locating  a  Record  in  a  Database  File 

To  locate  a  record  with  a  view  query,  first  enter  the  search  criteria  under  the 
relevant  fields.  Then  place  the  word  find  under  the  file  skeleton’s  name. 
dBASE  IV  will  locate  the  first  record  that  matches  the  criteria.  Since  the 
Find  operator  does  not  filter  records,  you  can  still  see  all  the  records,  even  if 
they  do  not  fit  the  search  conditions. 


Hiding  Duplicate  Records 

There  may  be  times  when  you  do  not  want  to  see  identical  records  in  a  view. 
For  example,  a  view  for  sending  out  a  mailing  might  show  names  and 
addresses  for  all  the  suppliers  to  each  division  of  a  company.  You  probably 
wouldn’t  want  to  send  more  than  one  copy  of  the  mailing  to  suppliers  who 
service  multiple  divisions. 

To  prevent  duplicate  entries  in  the  mailing  list,  place  the  word  Unique  under 
the  name  of  one  of  the  file  skeletons.  If  several  records  have  the  same  values 
for  every  field  in  the  view,  the  Unique  operator  tells  dBASE  IV  to  display 
only  one  of  these  records. 


Entering  Non-Specific  Conditions 

The  examples  so  far  use  specific  filter  conditions,  such  as  >  2000  or 
"Glendale" .  This  works  fine  when  you  want  to  compare  field  values  to  some 
specific  value. 

Suppose  you  want  to  compare  the  value  of  one  field  with  the  value  in  some 
other  field,  though.  To  do  this,  you  need  a  more  algebraic  approach,  where 
words  or  letters  represent  field  values.  You  can  enter  non-specific  conditions 
on  the  queries  design  screen  with  example  variables. 

Suppose  you  want  to  see  all  the  stocks  that  closed  within  two  points  of  their 
highest  value.  You  could  do  this  with  the  query  shown  in  Figure  7-15. 
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Figure  7-15  Example  variables  in  a  query 

The  letter  at  is  a  place  holder  for  whatever  value  is  in  the  Price_high  field. 
The  PRICE_CLOS  field  contains  a  condition  based  on  the  value  of  the 
Price_high  field. 

The  condition  >  =  x-2  tells  dBASE  IV  to  include  a  record  in  the  view  if  its 
closing  price  is  greater  than  or  equal  to  its  high  price,  even  after  subtracting 
two  from  the  high  price.  Figure  7-16  shows  the  resulting  view. 


Figure  7-16  A  view  created  with  example  variables 

You  can  enter  almost  any  value  for  an  example  variable,  as  long  as  you  use  it 
consistently  throughout  the  queries  design  screen.  Instead  of  at  and  >  =  x-2, 
for  example,  you  could  enter  kumquats  and  >  =  kumquats-2  or  examplel 
and  >  =  examplel  —  2. 
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Example  variables  may  be  up  to  ten  characters  long.  They  must  begin  with  a 
letter  and  cannot  contain  embedded  blanks.  Letters,  numbers,  and  under¬ 
scores  are  permitted. 

When  you  use  the  name  of  a  field  as  the  example  variable,  you  need  only 
enter  one  example  variable.  For  example,  the  file  skeleton  in  Figure  7-15 
could  be  written  as  shown  in  Figure  7-17. 


Layout  Fields  Condition  Update  Exit 
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Figure  7-17  A  field  name  used  as  an  example  variable 

If  there  is  more  than  one  file  skeleton  with  the  same  name  for  a  particular 
field,  you  can  still  use  the  field  name  as  an  example  variable  by  including  the 
name  of  the  file. 

The  example  variable  for  the  name  of  such  a  field  takes  the  form 
<  filename  >  ->  <  fieldname  >  .  For  example  if  there  was  another  file  skele¬ 
ton  on  this  queries  design  screen  with  a  Price_high  field,  you  could  write 
the  condition  as  >  =  Stockpric->  Price_  high  -2. 


Linking  Files 

You  can  use  the  queries  design  screen  to  link  two  or  more  database  files. 
The  data  from  these  files  can  then  be  used  to  form  one  view  with  data  from 
each  of  them . 

To  link  files,  place  the  same  example  variable  in  corresponding  field 
columns.  This  example  variable  works  as  a  place  holder.  So  long  as  two 
example  variables  are  the  same,  it  doesn’t  matter  what  they  are.  In  Figure 
7-18,  the  word  custnumber  is  the  example  variable  linking  Orders.dbf  with 
Cust.dbf. 
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Figure  7-1 8  Linking  files 


Each  order  in  Orders. dbf  is  matched  to  the  corresponding  customer  in 
Cust.dbf  according  to  the  customer  number.  This  lets  you  create  a  view  that 
contains  information  from  both  files.  There  will  be  one  record  for  every  cus¬ 
tomer  number  that  has  an  order  associated  with  it. 

Linking  works  best  when,  in  one  of  the  files,  each  value  of  the  common  field 
is  unique.  In  the  example  in  Figure  7-18,  if  two  customers  have  the  same 
customer  number,  the  link  is  ambiguous.  dBASE  IV  does  not  know  which 
customer  information  to  use  for  that  number. 
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Figure  7-19  A  view  with  a  linking  field  that  is  not  unique 


The  views  that  result  from  such  situations  show  all  possible  links.  In  Figure 
7-19,  it  seems  like  the  customers  with  the  duplicated  number  (C00001) 
ordered  the  same  set  of  items.  Each  of  them  will  receive  what  they  ordered, 
and  what  the  other  person  ordered.  This  example  shows  the  importance  of 
making  sure  that  linking  fields  are  unique. 


NOTE 

When  you  use  a  .vue  file  from  d BASE  II PLUS,  Jinks  between  database 
files  will  be  preserved  on  the  queries  design  screen^ if  two  conditions 
are  true.  The  files  must  be  linked  on  only  one  field  and  the  index  of 
the  child  database  file  must  be  thje  name  of  a  single  field. 


Displaying  All  the  Records  in  a  Fie 

The  link  in  Figure  7-18  shows  only  those  records  for  which  there  is  a  match 
between  the  files.  Anon-existent  customer  number  entered  in  the  Orders  file 
will  not  appear  in  the  view,  since  that  value  does  not  match  any  of  the  legiti¬ 
mate  customer  numbers  in  the  Customer  file. 
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There  may  be  times  when  you  want  to  see  all  the  records  even  though  they 
don’t  have  a  match.  For  example,  you  might  want  to  make  sure  each  order 
has  a  valid  customer.  You  can  do  this  by  placing  the  Every  operator  in  the 
Cust_id  field,  as  shown  in  Figure  7-20. 
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Figure  7-20  Asking  for  all  the  records  in  Orders.dbf 


This  will  produce  a  view  that  shows  every  record  in  Orders.dbf,  even  if  there 
is  no  matching  customer  number  in  Cust.dbf.  The  view  created  from  this 
view  query  is  shown  in  Figure  7-21. 

You  can  see  that  some  records  are  missing  Cust_id  values.  Unless  you  used 
the  Every  operator,  these  records  would  not  appear  in  the  view,  and  you 
might  not  know  that  some  of  the  orders  are  missing  customer  ID  numbers. 
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Figure  7-21  A  view  of  all  the  records  in  Orders.dbf 


If  you  want  to  see  every  customer,  even  those  who  have  not  placed  any 
orders,  put  the  Every  operator  in  the  Client. id  column  of  the  Cust.dbf 
skeleton. 


NOTE 

You  can  place  the  Every  operator  in  only  one  file  at  a  time. 
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Making  Limited  Links 

Typical  queries  created  on  the  queries  design  screen  find  every  record  that 
matches  the  linking  value.  Sometimes,  however,  you  want  to  see  just  one  of 
each  record  that  matches  the  linking  value. 
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Figure  7-22  Two  files  linked  on  the  City  field 


In  Figure  7-22,  the  database  files  are  linked  on  City.  The  resulting  view  in 
Figure  7-23  shows  all  the  people  in  the  two  database  files  who  live  in  the 
same  city. 
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Figure  7-23  A  view  of  two  files  linked  on  the  City  field 
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Notice  that  many  of  the  city  names  in  Figure  7-23  appear  more  than  once. 
Suppose  you  wanted  to  see  only  one  person  for  each  different  city  in  the 
Names  database  file.  Use  the  First  operator,  as  shown  in  Figure  7-24. 


Figure  7-24  Two  files  linked  with  a  First  operator 

For  each  record  in  Names.dbf,  the  First  operator  tells  dBASE  IV  to  find  the 
first  record  in  Employee. dbf  that  matches  the  city  in  the  Names.dbf  record. 
Any  additional  records  in  Employee. dbf  with  the  same  value  in  the  City  field 
do  not  appear  in  the  view.  The  resulting  view  is  shown  in  Figure  7-25. 
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Figure  7-25  A  view  made  by  a  query  with  the  First  operator 
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The  First  operator  creates  views  similar  to  dBASE  III  PLUS  views.  For  this 
reason,  when  you  import  a  dBASE  III  PLUS  view,  the  First  operator  is  auto¬ 
matically  placed  in  the  skeleton  of  the  dependent  database  file.  (The  depen¬ 
dent  file  is  the  one  named  after  the  INTO  keyword  of  the  SET  RELATION 
command.) 


Self-joins 


There  may  be  times  when  you  want  to  use  one  field  in  a  database  file  to  filter 
all  the  other  records  in  that  database  file.  This  happens  whenever  you  want 
to  answer  questions  like  these: 

■  Which  employees  live  in  the  same  neighborhood  as  some  other 
employee? 

■  Which  employees  make  more  money  than  their  supervisor? 

■  Which  students  are  also  the  teachers  for  other  students? 

Questions  like  these  are  really  double  questions.  Take  the  first  one,  for  exam¬ 
ple.  It  can  be  broken  into  two  questions: 

1.  Which  neighborhood  does  this  employee  live  in? 

2.  Does  any  other  employee  live  in  this  neighborhood? 

In  order  to  answer  a  question  like  this,  each  record  in  the  database  file  must 
be  compared  to  every  other  record.  You  can  ask  dBASE  IV  to  handle  this 
type  of  query  by  placing  the  database  file’s  skeleton  on  the  queries  design 
screen  twice.  The  system  will  assign  a  temporary  name  to  the  second  copy  of 
the  file^skeleton  to  the  distinguish  it  from  the  first  file  skeleton  of  the  same 
file. 


|j 
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The  queries  design  surface  handles  this  much  the  way  you  would  in  real  life. 
One  file  skeleton  is  used  as  the  base  from  which  a  single  record  is  chosen. 
This  record  is  then  compared  to  all  the  records  represented  by  the  other  file 
skeleton. 


Figure  7-26  shows  two  file  skeletons  for  Employee. dbf  linked  on  the  Zip 
field.  The  view  will  show  the  last  names  and  zip  codes  of  all  employees  who 
live  in  the  same  zip  code  area.  To  prevent  duplicate  records  in  the  view,  the 
Unique  operator  has  been  added  to  this  query. 


Including  Complex  Indexes 

Complex  indexes  may  help  dBASE  IV  organize  the  records  in  your  query.  To 
include  complex  indexes  in  a  file  skeleton,  choose  the  Include  indexes 
.option  from  the  Fields  menu. 

^All  complex  indexes  for  the  current  database  file  are  placed  at  the  end  of  the 
file  skeleton.  Instead  of  a  field  name,  they  show  a  pound  sign  (#)  followed  by 
their  index  expressions.  The  index  is  not  a  real  field,  but  since  it  looks  like 
one  in  the  file  skeleton,  it  is  called  a  pseudo-field.  You  can  also  treat  these 
complex  indexes  like  other  fields  in  the  file  skeleton  for  linking,  sorting,  and 
filtering. 

The  Include  indexes  option  also  indicates  all  simple  indexes  (based  on  sin¬ 
gle  fields)  with  a  pound  sign  to  the  left  of  the  field  name.  This  lets  you  know 
which  fields  already  have  indexes,  so  you  can  choose  efficient  ways  to  orga¬ 
nize  your  records. 
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Suppose  you  want  to  organize  your  records  by  State  and  City,  like  the 
records  in  Figure  7-7.  The  view  query  in  Figure  7-6  does  this  with  two  sort¬ 
ing  operators,  one  for  City  and  one  for  State.  When  you  perform  the  query, 
the  records  must  be  organized  according  to  the  values  in  the  City  and  State 
fields. 

Suppose  you  already  have  a  complex  index  based  on  these  two  fields,  with 
an  expression  something  like  State  +  City.  You  can  simplify  the  work  needed 
to  perform  the  query  by  including  this  existing  index  in  the  file  skeleton. 
Then  you  can  remove  the  two  sorting  operators  from  the  City  and  State  col¬ 
umns  and  put  just  one  sorting  operator  into  the  complex  index  column. 
Since  this  index  has  already  organized  the  records  by  State  and  City, 
performing  the  query  will  take  less  time. 

You  can  also  use  complex  indexes  for  linking  one  file  skeleton  to  another. 
For  example,  suppose  you  have  two  large  database  files  with  duplicated  last 
names  and  first  names,  but  no  unique  key  field  such  as  a  customer  number. 
You  could  make  a  complex  index  for  both  files  based  on  last  name,  first 
name,  and  home  zip  code.  Then  you  could  link  the  two  files  according  to 
their  complex  indexes. 


Browsing  and  Editing  a  View 

When  you  create  a  view  from  a  single  file  skeleton,  you  can  use  all  the  func¬ 
tionality  of  Browse  or  Edit.  If  you  change  the  information  in  the  view,  the 
underlying  data  in  the  database  file  will  reflect  the  change. 

There  are  times,  however,  when  you  cannot  change  the  data  in  a  view: 

■  You  cannot  modify  data  in  a  view  with  a  query  using  more  than  one 
database  file.  This  includes  views  made  with  two  copies  of  the  same  file 
skeleton. 

■  You  cannot  change  the  data  in  a  view  if  it  has  a  field  defined  by  a  sum¬ 
mary  operator  (SUM,  AVG,  CNT,  MIN,  or  MAX). 

■  You  cannot  revise  a  calculated  field  in  a  view.  You  can,  however,  revise 
the  other  fields  in  a  view  that  contains  a  calculated  field. 

■  You  cannot  change  the  data  in  a  view  if  the  file  skeleton  contains  a  sort¬ 
ing  operator  for  a  field  that  does  not  already  have  an  index  based  on  it. 

Even  when  you  cannot  change  the  data  in  a  view,  you  can  still  use  Edit  or 
Browse  to  display  the  data,  and  the  data  in  the  view  can  be  used  to  make 
reports  and  labels. 


Doing  Updates 

The  queries  design  screen  increases  your  power  and  flexibility  to  change 
data.  You  can  pick  which  records  and  fields  to  change,  specify  how  to 
change  the  data,  and  determine  where  the  new  data  will  come  from.  The 
four  update  operators  are  Replace,  Append,  Mark,  and  Unmark. 

You  can  enter  an  update  operator  by  typing  it  on  the  screen  under  the  name 
of  the  database  file  you  want  to  update.  You  can  also  choose  the  Specify 
update  operation  option  from  the  Update  menu. 
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An  update  query  is  defined  whenever  you  place  an  update  operator  in  a  file 
skeleton  under  the  name  of  the  file.  Although  you  may  have  more  than  one 
file  skeleton  on  the  screen,  only  one  of  them  may  contain  an  update  opera¬ 
tor.  The  file  with  the  update  operator  is  the  target  i\\t.  This  is  the  database 
file  that  will  be  updated. 

If  you  previously  selected  some  fields  to  be  in  a  view,  the  view  skeleton  dis¬ 
appears  when  you  enter  an  update  operator,  since  an  update  query  does  not 
produce  a  view. 

When  update  queries  are  saved,  they  appear  in  the  Control  Center  with  an 
asterisk  (*)  to  the  left  of  their  name. 

Replacing  Values 

The  Replace  operator  requires  a  replacement  instruction  in  the  file  skeleton. 
This  instruction  begins  with  the  word  with ,  followed  by  a  dBASE  expression. 
Any  other  conditions  are  filters  to  select  the  records  to  be  updated. 


In  Figure  7-27,  the  update  query  gives  all  employees  a  10%  raise.  In  Figure 
7-28,  the  update  query  selects  all  the  clerks,  changes  their  title  to  aides,  and 
gives  them  a  10%  raise. f 
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Figure  7-28  Filtering  records  before  replacing  values 

Appending  Records 

The  Append  operation  helps  you  add  selected  records  to  the  target  file.  The 
update  query  in  Figure  7-29  appends  information  from  Names. dbf.  Notice 
that  the  Client  field  in  the  target  database  file  modifies  the  data  from 
Names. dbf  before  storing  it. 


You  can  also  add  filters  in  the  Names. dbf  skeleton  so  that  only  certain 
records  are  appended  to  Cust.dbf. 
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Marking  Records  for  Deletion 

When  you  use  the  Mark  operator,  the  conditions  in  the  columns  select  the 
records  to  be  marked  for  deletion.  All  records  that  satisfy  the  filter  are 
marked.  If  there  are  no  conditions  in  the  columns,  all  records  are  marked. 

In  Figure  7-30,  all  parts  that  contain  the  word  tabled will  be  marked  for 
removal  from  Inventry.dbf. 


Records  marked  for  deletion  with  the  Delete  operator  are  not  physically 
removed  from  the  database  file.  That  occurs  only  when  you  issue  a  PACK 
command  from  the  dot  prompt  or  choose  Erase  marked  records  from  the 
Organize  menu  on  the  database  design  screen. 
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Unmarking  Records  Marked  for  Deletion 

When  you  use  the  Unmark  operator,  the  conditions  in  the  columns  select  the 
records  to  be  unmarked.  All  records  that  satisfy  the  filter  are  unmarked.  If 
there  are  no  conditions  in  the  columns,  all  records  are  unmarked. 


Figure  7-31  Unmarking  selected  records 

In  Figure  7-31,  all  parts  that  contain  the  word  tabled  re  reinstated  to 
Inventry.dbf. 


Performing  an  Update  Query 

When  you  select  the  Perform  the  update  option,  dBASE  IV  first  checks  your 
update  query.  Then  it  prompts  to  make  sure  you  want  to  do  the  update.  If 
you  confirm  this,  dBASE  IV  updates  the  target  file.  You  will  still  be  on  the 
queries  design  screen,  and  you  can  display  the  updated  database  file  by 
pressing  F2  Data. 

How  View  Queries  Define  Views 


You  create  the  instructions  that  make  up  an  update  query  on  the  queries 
design  screen.  dBASE  IV  then  takes  the  design  from  the  screen  and 
processes  it  into  a  view  query  file.  This  file  contains  individual  commands  to 
create  the  view.  You  could  use  these  same  commands  from  the  dot  prompt. 
To  find  out  more  about  how  views  are  created  from  the  query  file,  look  up 
the  following  commands  in  Language  Reference : 


SET  RELATION 
SET  FILTER 
SET  FIELDS  TO 
SET  INDEX 
SET  ORDER 
BROWSE  [FIELDS] 
EDIT  [FIELDS] 


SELECT 

USE 

DO  WHILE 
CALCULATE 
INDEX 
SORT 
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M  TIP 

If  you  want  to  see  the  dBASE  IV  code  used  by  the  view  query,  you  can 
1^14  examine  it  by  entering  the  TYPE  <  queryname  >  command  at  the  dot 
prompt.  You  can  also  use  the  View  option  from  the  Operations  menu 
on  the  DOS  utilities  menu  bar.  This  menu  bar  is  reached  from  the 
Ibok  menu. 

If  you  are  an  experienced  dBASE  III  PLUS  user,  looking  at  the  code 
this  way  may  help  you  understand  exactly  how  the  queries  design 
screen  does  its  work. 


Using  the  Queries  Design  Menu  Bar 

The  queries  design  screen  contains  menus  to  help  you  construct  view  que¬ 
ries  and  update  queries.  As  you  work  with  the  screen  more  and  more,  you 
may  want  to  supplement  some  of  these  menu  options  with  keystroke  short¬ 
cuts.  You  can  also  carry  out  several  of  the  menu  options  by  typing  relevant 
operators  directly  onto  the  work  surface. 


The  Layout  Menu 


The  Layout  menu  contains  com¬ 
mands  that  help  you  add  and 
remove  files,  link  files  together, 
save  queries,  and  save  the  data  gen¬ 
erated  by  view  queries. 

Add  File  to  Query 

If  there  is  a  current  catalog,  this  option  presents  a  list  of  all  the  database  files 
in  the  catalog.  If  there  is  no  current  catalog,  then  a  list  of  the  database  files 
on  your  current  drive/directory  appears.  You  can  use  this  list  to  choose  data¬ 
base  files  from  other  drives  and  directories  also. 

Once  you  choose  a  database  file  to  add  to  the  queries  design  screen,  a  file 
skeleton  for  the  file  appears  on  the  work  surface. 

Remove  File  from  Query 

This  option  removes  the  highlighted  file  skeleton  or  calculated  field  skeleton 
from  the  queries  design  work  surface. 


WARNING 

When  you  ask  to  remove  a  file  from  the  queries  design  surface,  it  is 
removed  without  a  confirming  prompt  box.  This  makes  the  surface 
more  responsive,  but  be  sure  the  cursor  is  on  the  correct  file  skele¬ 
ton  before  you  choose  this  option. 
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Create  Link  by  Pointing 

This  option  helps  you  link  two  files  together.  First  position  the  cursor  in  the 
column  of  a  field  you  want  to  use  to  link  one  file  with  another. 

When  you  choose  this  option,  a  link  marker  is  placed  in  the  current  field. 
Now  position  the  cursor  in  the  column  of  the  linking  field  in  another  file 
skeleton.  Pressing  -«-►  finishes  the  operation,  and  dBASE  IV  links  the  two  files 
on  the  indicated  fields. 

Links  between  files  are  shown  by  the  example  variables  Linkl,  Link2 ,  and  so 
on.  Each  link  pairs  together  two  files.  To  link  three  files,  you  need  two  links. 

You  could  also  enter  these  links  yourself  by  typing  example  variables,  as 
described  earlier  in  this  chapter  in  the  “Linking  Files”  section. 


Write  View  as  Database  File 

When  defining  a  view,  you  can  write  the  data  in  the  view  to  a  new  database 
file.  You  may  accept  the  current  view  name,  which  will  have  the  .dbf  exten¬ 
sion  added  automatically.  You  can  also  enter  a  new  name  for  the  new  data¬ 
base  file. 

This  option  makes  a  physical  copy  of  filtered  and  selected  data,  similar  to  the 
way  the  SORT  command  produces  a  physical  copy  of  a  rearranged  database 
file. 

Generally,  you  will  have  a  more  efficient  database  system  if  you  leave  your 
data  in  its  original  database  files,  taking  advantage  of  view  queries  and 
indexes  to  reorganize  the  data  in  RAM.  That  way  you  won’t  have  copies  on 
your  disk  of  data  that’s  already  stored  in  other  database  files. 

This  option  is  useful,  however,  when  you  want  to  capture  data  as  of  a  certain 
date  for  accounting  purposes.  You  can  also  use  it  to  select  specific  data  for 
transfer  to  someone  else.  You  could,  for  example,  take  names  and  phone 
numbers  from  a  master  employee  database  to  make  a  phone  list,  without 
including  other  more  personal  data  from  the  master  database. 

Since  update  queries  modify  existing  database  files  without  creating  views, 
this  option  is  not  available  for  update  queries. 

NOTE 

This  snapshot  of  your  view  will  be  a  new  database  file,  unconnected 
to  the  underlying  database  files  that  created  it.  This  means  that  you 
may  need  to  make  changes  to  data  in  the  snapshot  file  or  the  underly¬ 
ing  files  in  both  places. 

If  you  want  changes  to  your  underlying  database  files  to  be  automati¬ 
cally  shown  in  a  view,  save  the  view  query  without  writing  the  view 
as  a  database  file.  When  you  perform  the  view  query  to  re-create  the 
view,  the  view’s  data  will  automatically  be  up-to-date. 
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Edit  Description  of  Query 

This  option  lets  you  modify  the  catalog  description  of  the  current  query.  It  is 
not  available  if  there  is  no  open  catalog. 

Save  This  Query 

After  you  select  this  option,  a  prompt  box  appears  for  assigning  a  name  to 
the  query. 

If  you  are  creating  a  new  query  from  the  Control  Center,  you  must  enter  a 
name  for  it  now.  If  the  query  already  has  a  name,  you  may  accept  this  name 
by  pressing  ♦-►,  or  you  may  enter  a  new  name  before  pressing  A  .qbe 
extension  is  automatically  added  to  query  filenames,  and  a  .upd  extension  is 
added  to  update  query  filenames. 

You  should  not  change  these  default  extensions  if  you  want  to  reload  the 
query  onto  the  queries  design  screen  or  use  it  in  the  normal 
manner. 

After  you  have  assigned  the  query’s  name,  dBASE  IV  checks  the  complete¬ 
ness  and  accuracy  of  your  view  query  or  update  query.  If  the  query  is  prop¬ 
erly  constructed,  it  will  be  saved  to  disk.  If  the  query  contains  an  error,  a 
message  appears  to  describe  the  problem. 

When  the  message  line  at  the  bottom  of  the  screen  contains  the  message 
Syntax  error,  the  cursor  highlights  the  place  in  the  query  containing  the 
error. 


NOTE 

You  can  watch  dBASE  IV  create  the  code  for  your  query  by  setting 
INSTRUCT  to  OFF  and  TALK  to  ON 


The  Fields  Menu 


The  Fields  menu  offers  options  to 
help  you  add  fields,  remove  fields, 
change  field  names  for  the  view, 
and  sort  the  records  in  a  view. 


Add  Field  to  View 

To  add  a  field  to  the  view,  position  the  cursor  in  the  field’s  column  in  the 
database  file  skeleton.  When  you  choose  this  option,  an  image  of  the  field 
you  have  chosen  will  be  placed  in  the  view  skeleton. 

This  can  also  be  done  by  pressing  F5  Field.  See  the  “Adding  Fields  to  a 
View”  section  earlier  in  this  chapter  for  more  details. 
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Remove  Field  from  View 

Use  this  option  to  remove  the  current  field  from  the  view.  You  can  also 
press  F5  Field  when  the  cursor  is  highlighting  a  field  in  the  file  skeleton, 
calculated  field  skeleton,  or  view  skeleton. 

Edit  Field  Name 

If  you  want  to  place  a  calculated  field  in  the  view  skeleton,  you  must  give  it 
a  name.  You  can  also  use  the  calculated  field’s  name  in  conditions  on  the 
queries  design  surface  and  in  the  condition  box. 

Sometimes  you  may  want  to  rename  fields  in  the  view  skeleton,  to  display 
different  field  names  in  the  view  than  the  names  used  in  the  database  file.  In 
addition,  all  the  field  names  in  a  view  skeleton  must  be  unique. 

You  can  use  the  Edit  field  name  option  to  rename  a  column  in  either  the 
view  skeleton  or  the  calculated  fields  skeleton.  The  new  name  appears  in  the 
column  heading,  followed  by  an  equal  (=  )  sign. 


Create  Calculated  Reid 

When  you  select  this  option,  a  skeleton  with  the  name  of  Calc’d  Fids  is  cre¬ 
ated.  If  the  calculated  fields  skeleton  already  exists,  a  new  column  is  added 
to  the  skeleton. 

The  cursor  will  appear  in  a  new  column  of  the  calculated  fields  skeleton. 

You  may  then  type  in  the  expression  for  the  calculated  field.  The  expression 
may  be  any  valid  dBASE  expression,  such  as  quantity  *  price. 

Calculated  fields  are  evaluated  from  left  to  right. 

Sort  on  this  Field 

When  you  choose  this  option,  a  prompt  box  appears  with  these  choices: 

Ascending  ASCII  (A..Za..z,0..9) 

Descending  ASCII  (z..aZ..A,9..0) 

Ascending  Dictionary  (Aa ..Zz,0..9) 

Descending  Dictionary  (zZ..aA,9..0) 

Ascending  ASCII  order  means  Zebra  comes  before  aardvark.  Ascending  dic¬ 
tionary  order  means  the  ordering  is  not  sensitive  to  whether  letters  are 
upper  case  or  lower  case. 

Once  you  choose  the  type  of  sort,  the  relevant  operator  is  placed  in  the  col¬ 
umn  of  the  current  field.  The  possible  operators  for  the  first  sort  field  are 
Ascl,  Dscl,  AscDictl,  and  DscDictl.  As  you  add  additional  fields,  their  sort 

I  operators  are  given  higher  and  higher  numbers.  Your  third  sort  field,  for 

example,  might  be  Dsc3. 

You  can  also  position  the  cursor  and  type  in  the  sort  operators  and  numbers 
directly.  You  can  enter  the  sort  operators  in  any  order,  but  you  cannot  enter 
two  with  the  same  sort  number. 
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Include  Indexes 

Many  times  a  database  file  has  indexes  that  are  more  complicated  than  single 
fields.  Setting  this  option  to  YES  lets  you  include  such  indexes  in  the  cur¬ 
rent  database  file’s  skeleton.  You  can  then  sort  the  records  in  the  view  with 
these  more  complicated  indexes. 

This  menu  option  toggles  between  YES  and  NO.  Toggling  the  option  to  NO 
will  remove  these  complex  index  fields  from  the  screen  for  the  current  file 
skeleton.  On  the  same  queries  design  screen,  you  can  include  complex 
indexes  for  some  files  and  not  others. 

Fields  that  are  already  indexed  usually  allow  faster  sorting,  linking,  and  fil¬ 
tering.  For  this  reason,  any  field  that  has  an  index  is  shown  with  a  pound 
sign  (#)  before  its  name.  You  can  tell  the  difference  between  an  actual  field 
in  the  database  file  and  a  complex  index  field,  since  the  actual  field  will  not 
have  an  expression  even  if  it  does  have  a  crosshatch. 

The  column  heading  for  complex  indexes  will  show  the  index  expressions 
preceded  by  a  crosshatch.  The  crosshatch  helps  distinguish  these  special 
fields  from  fields  that  do  not  have  indexes. 


The  Condition  Menu 


The  Condition  menu  controls  the 
display  of  the  condition  box  on  the 
work  surface.  You  can  also  use  this 
menu  to  enter  a  condition  into  the 
box. 


Add  Condition  Box 

This  option  displays  a  condition  box  if  one  is  not  displayed  already.  There  is 
only  one  condition  box  per  query  (or  update  query). 

The  condition  box  holds  a  condition  applied  to  the  whole  query.  Only 
records  satisfying  the  condition  are  allowed  into  the  view  or  update.  The 
condition  box  is  particularly  helpful  for  expressions  involving  fields  from 
several  different  file  skeletons. 

You  can  enter  a  condition  into  the  condition  box  by  typing  it  in  directly.  You 
can  also  use  Shrft-FI  Pick  to  display  a  list  of  possible  fields  and  operators. 

Delete  Condition  Box 

This  option  removes  the  condition  box  from  the  queries  design  screen. 

Show  Condition  Box 

This  option  toggles  the  display  of  the  condition  box  from  the  regular  condi¬ 
tion  box  to  a  marker  that  reads  CONDITION  BOX.  When  you  place  the  cur¬ 
sor  on  the  marker  with  F3  Previous  or  F4  NjSfT  the  marker  automatically 
opens  into  the  condition  box.  You  can  also  press  F9  Zoom  to  zoom  the  con¬ 
dition  box  to  a  larger  size. 
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The  Update  Menu 


The  Update  menu  contains  special 
commands  that  apply  to  update 
queries. 


Perform  the  Update 

This  option  is  only  available  for  an  update  query.  When  you  choose  this 
option,  dBASE  IV  first  checks  your  update  query,  then  carries  out  the  speci¬ 
fied  changes  to  the  target  file. 

After  the  changes  have  been  made,  a  message  box  indicates  how  many 
records  were  changed.  You  may  then  press  F2  Data  to  BROWSE  the  changed 
target  file  or  continue  working  on  the  queries  design  screen. 


Specify  Update  Operation 

This  option  lets  you  choose  which  update  operator  to  use.  You  can  either 
replace,  append,  mark,  or  unmark  records.  Only  one  update  operation  is 
allowed  per  query. 

Once  you  choose  an  update  operation,  the  operator  appears  under  the  name 
of  the  current  file  skeleton.  This  file  then  becomes  the  target  file  for  the 
query,  and  the  word  Target  displays  in  its  file  skeleton. 


If  an  operation  already  exists  for  the  query,  the  newly  chosen  operation 
replaces  the  old  one.  If  you  change  a  view  definition  query  to  an  update 
operation,  the  view  skeleton  is  deleted.  You  are  given  a  warning  prompt  to 
make  sure  you  want  to  delete  the  view  skeleton. 

You  may  move  the  cursor  to  the  operator  and  edit  or  delete  it,  thereby 
changing  the  type  of  query.  You  can  also  type  in  an  operator  if  there  is  none, 
changing  a  regular  query  to  an  update  query. 


The  Exit  Menu 


With  the  Exit  menu,  you  can  leave 
the  queries  design  screen. 


Return  to  Report/Form/Label  Design 

There  are  several  ways  you  can  reach  the  queries  design  screen.  If  you  come 
from  the  Control  Center,  dot  prompt,  database  design  screen,  or  a  program, 
this  option  will  not  appear  in  the  Exit  menu. 

If  you  come  to  the  queries  design  screen  from  the  forms,  reports,  or  labels 
design  screens,  this  option  will  appear  with  the  relevant  destination.  For 
example,  if  you  were  designing  a  report  and  came  directly  to  the  queries 
design  screen,  this  option  reads  Return  to  Report  Design.  Choosing  this 
option  would  then  return  you  to  the  reports  design  screen. 
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You  can  also  press  Shift-F2  Design  to  return  to  a  forms,  reports,  or  labels 
design  screen. 

Save  Changes  and  Exit 

You  can  use  this  option  to  save  a  new  or  modified  query.  If  the  query  does 
not  have  a  name  yet,  a  prompt  appears  so  you  can  name  it. 

If  you  came  to  the  queries  design  screen  from  the  Control  Center,  then  you 
will  return  to  the  Control  Center.  If  you  came  from  the  dot  prompt  or  a  pro¬ 
gram,  you  will  return  to  the  dot  prompt  or  program. 

If  you  came  to  the  queries  design  screen  from  the  forms,  reports,  or  labels 
design  screens  and  you  have  any  unsaved  design  changes,  you  will  be 
returned  to  that  design  screen  and  asked  if  you  want  to  save  the  new 
material. 

Abandon  Changes  and  Exit 

After  you  select  this  option,  you  will  be  asked  to  verify  that  you  want  to  aban¬ 
don  your  changes.  If  you  confirm  this  intention,  any  unsaved  changes  to  the 
query  are  abandoned. 

If  you  came  to  the  queries  design  screen  from  the  Control  Center,  you  will 
return  to  the  Control  Center.  If  you  came  from  the  dot  prompt  or  a  program, 
you  will  return  to  the  dot  prompt  or  program. 
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Designing 

Forms 


Introduction 

You  can  display  the  data  in  a  database  file  or  view  on  either  the  Browse 
screen  or  the  Edit  screen.  The  Browse  screen  always  displays  a  standard 
table  format,  where  each  row  represents  a  separate  record. 

The  display  on  the  Edit  screen,  on  the  other  hand,  is  quite  flexible.  By 
designing  a  custom  form,  you  can  rearrange  the  fields  on  the  screen,  add 
boxes  or  lines  for  emphasis,  omit  certain  fields  to  simplify  the  display,  or  add 
calculated  fields. 

By  combining  views  and  forms,  you  can  easily  create  data  entry  and  retrieval 
systems  that  share  the  same  underlying  database  file  but  appear  quite  differ¬ 
ent  on  the  surface. 

This  chapter  describes  how  to  use  the  forms  design  screen  to  customize  your 
screen  displays. 


Form  Files 

Each  different  Edit  screen  you  design  is  stored  in  a  form.  As  you  use  a  form 
for  data  entry  or  retrieval,  you  may  discover  ways  to  fine-tune  it.  You  can 
then  return  to  the  forms  design  screen  to  modify  your  form. 

You  can  also  copy  a  form  and  adapt  its  design  to  display  data  from  different 
database  files  or  views.  The  names  of  all  the  forms  in  your  current  catalog 
are  shown  in  the  Forms  panel  of  the  Control  Center. 

The  Quick  Layout 

dBASE  IV  provides  a  basic  design  for  the  Edit  screen.  This  default  form  dis¬ 
plays  each  field  from  a  database  file  or  view  on  the  screen,  devoting  a  line  to 
each  field.  The  field  names  appear  flush  left,  with  the  field  data  to  the  right. 
The  field  width  is  the  same  as  in  the  underlying  database  file. 

The  default  form  is  used  whenever  you  have  not  specified  a  customized 
form.  To  design  customized  forms,  you  use  the  forms  design  screen, 
described  below. 
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Using  the  Forms  Design  Screen 

The  forms  design  screen  has  menus  and  a  work  surface.  The  work  surface 
uses  the  layout  editing  mode,  which  is  described  in  Chapter  4,  “The  Editors.” 

You  can  place  five  design  elements  on  a  form: 

■  Fields  from  an  underlying  database  file  or  view 

■  New  calculated  fields  not  already  in  the  database  file  or  view 

■  Text 

■  Boxes 

■  Lines 


Figure  8-1  The  forms  design  screen 

A  form  cannot  be  wider  than  the  screen,  but  it  can  be  longer.  You  reach  the 
upper  or  lower  parts  of  a  form  by  scrolling  up  or  down  with  the  appropriate 
cursor  keys. 
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The  form  design  shown  in  Figure  8-1  produces  the  finished  form  shown  in 
Figure  8-2. 


NOTES*  Renenber  to  send  Ralph  and  Alice  a  thank-you 


Figure  8-2  The  final  form 

Forms  give  you  flexible  ways  to  organize  your  data.  You  can,  for  example, 
add  calculated  fields  when  you  make  a  view,  or  wait  until  you  design  the 
form.  You  can  restrict  the  form’s  display  of  certain  data,  such  as  salary  infor¬ 
mation,  even  though  the  fields  containing  that  data  are  still  part  of  the 
underlying  database  file  or  view.  You  can  also  assign  special  picture  func¬ 
tions  to  fields  on  a  form,  making  it  easier  to  enter  or  display  data. 


NOTE 

If  you  try  to  enter  double  quotation  marks  (”)  on  the  design  screens  for 
forms,  reports,  or  labels,  the  system  will  beep.  This  is  bee  a  useldBASE 
IV needs  double  quotation  marks  when  it  creates  forms,  reports,  and 
labels.  You  may,  however,  use  single  quotation  marks  ('). 


For  pointers  on  good  form  design,  please  see  Iking  the  d BASE  IV 
Applica  tions  Gen  era  tor. 


Using  the  Forms  Design  Menu  Bar 

The  forms  design  menu  bar  contains  five  menus:  Layout,  Fields,  Wu  rdT^Jtio 
To,  and  Exit. 

Four  of  these  menus  —  Fields,  Words,  Go  To,  and  Exit  —  are  similar  to 
menus  on  the  design  screens  for  reports  and  labels. 

This  chapter  describes  the  Layout  menu  for  forms.  The  Words  menu  is 
described  in  Chapter  4,  “Editing.”  The  Go  To  menu  is  described  in  Chapter 
3,  “Browse  and  Edit.” 
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The  Fields  menu  is  described  in  detail  in  Chapter  9,  “Designing  Reports.”  In 
the  “The  Forms  Fields  Menu”  section  below,  you  will  find  a  description  of 
the  Picture  functions  and  Edit  options  offered  by  the  Fields  menu  for  the 
forms  design  screen. 

The  Exit  menu  lets  you  choose  Save  changes  and  exit  or  Abandon  changes 
and  exit.  If  you  save  your  changes,  you  have  the  option  of  changing  the 
name  of  the  form. 


The  Layout  Menu 

The  Layout  menu  provides  several 
options  to  help  you  design  or  mod¬ 
ify  forms. 


Quick  Layout 

This  option  uses  the  Quick  Layout  design  to  place  all  the  fields  from  the 
underlying  database  file  or  view  onto  the  forms  design  surface.  Each  field 
occupies  a  single  line,  with  the  field  names  at  the  left,  followed  by  the  field 
templates.  Afield  template  represents  the  width  and  composition  of  data 
entry  areas  for  each  field. 

After  you  choose  the  Quick  layout  option,  you  can  modify  or  delete  the 
fields  that  have  been  automatically  placed  on  the  forms  design  work  surface. 
You  can  also  move  the  fields  wherever  you  want  on  the  screen  and  then  add 
boxes  or  lines  for  emphasis. 

If  there  is  no  current  database  file  or  view  when  you  ljach  the  forms  design 
screen,  this  option  will  be  dimmed.  The  cursor  will  appear  on  the  Usejdif- 
ferent  database  file  or  view  option. 

Box 

The  Box  option  lets  you  draw  a  box  on  the  form.  Boxes  are  helpful  for  visu¬ 
ally  connecting  related  information. 

When  you  choose  this  option,  you  are  given  a  choice  of  making  the  border 
from  a  single  line,  a  double  line,  or  some  special  character.  If  you  choose 
the  Using  specified  character  option,  a  list  appears  of  possible  IBM 
extended  ASCII  characters.  Choose  the  character  you  want  by  pressing 

Once  you  have  specified  the  border  character,  place  the  cursor  where  you 
want  the  top  left  corner  of  the  box  to  appear  and  press  Move  the  cursor 
towards  where  you  want  to  place  the  bottom  right  corner  of  the  box.  A  tem¬ 
porary  box  is  drawn  as  you  move  the  cursor.  When  the  lower  right  corner  of 
the  temporary  box  is  where  you  want  it,  press  and  the  box  will  be 
complete. 

You  can  use  the  Display  option  in  the  Words  menu  to  modify  the  appear¬ 
ance  of  the  box. 
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NOTE 

When  you  print  a  report  that  contains  graphics  characters,  dDASE  IV 
tells  your  printer  to  use  the  Closest  possible  characters.  If  your  printer 
has  minimal  graphics  capability,  lines  will  be  shown  by  dashes  (-)  and 
equals  signs  (=  ),  corners  by  plus  signs  (+  ),  and  vertical  lines  by 
colons  (:). 

Line 

After  you  choose  this  option,  you  must  decide  whether  you  want  to  draw  a 
single  line,  a  double  line,  or  a  line  of  characters.  If  you  choose  the  Using 
specified  character  option,  a  list  appears  of  possible  IBM  extended  ASCII 
characters.  Choose  the  character  you  want  by  pressing 

Once  you  select  the  type  of  line  or  character  to  use,  place  the  cursor  where 
you  want  to  start  the  line.  Press  •«-»•  and  use  the  arrow  keys  to  draw  the  line 
in  the  direction  you  want.  For  example,  to  draw  a  double  line  across  the 
screen,  choose  the  Line  option,  the  Double  line  option,  position  the  cursor, 
press  •«-*,  and  press  «-  or  You  can  draw  up  or  down  the  screen  by  press¬ 
ing  f  or  J,.  When  you  are  done  drawing,  press  •*-». 

If  you  want  to  delete  a  part  of  a  line  while  you  are  drawing,  press 
Backspace.  After  you  finish  drawing  a  line,  it  is  treated  as  normal  text,  so 
you  can  edit  lines  just  as  you  do  text. 

M  TIP 

You  can  use  the  cursor  as  an  eraser  by  choosing  the  Using  specified 
character  option  and  picking  the  blank  character.  This  character  has 
the  number  32  in  the  left  column. 


Use  Different  Database  File  or  View 

A  form  created  from  the  Control  Center  is  usually  associated  with  a  specific 
database  file  or  view.  The  Use  different  database  file  or  view  option  lets 
you  choose  a  different  source  of  data  to  use  with  the  current  form.  Unless 
you  save  the  form,  this  is  only  a  temporary  change.  The  next  time  you  use 
the  form,  it  will  still  point  to  the  original  database  file  or  view. 

This  is  useful  when  you  have  database  files  or  views  with  the  same  structure, 
and  you  don’t  want  to  store  separate  copies  of  a  form  for  each  data  file.  You 
can  assign  the  form  to  the  most  commonly  used  data  file.  Then,  when  you 
want  to  display  the  data  in  one  of  the  other  files,  use  this  option  to  substitute 
that  file  for  the  one  normally  pointed  to  by  the  current  form. 

If  you  try  to  use  a  database  file  or  view  with  fields  that  do  not  match  those 
already  on  the  forms  design  work  surface,  an  error  message  appears  listing 
the  names  of  the  fields  not  found  in  the  database  file  you  have  selected. 

If  you  get  this  error  message,  you  may  want  to  choose  a  different  database 
file  or  view  that  has  all  the  fields  needed  by  the  form.  You  could  also  remove 
all  the  field  templates  from  the  design  screen  that  do  not  exist  in  the  data¬ 
base  file  or  view  you  have  just  chosen. 


USING  THE  MENU  SYSTEM 


8-5 


JOBNANE:  PAGE:  G  SESS:  G  Fr  i  Hay  20  13:36:15  1988 

@tate/d  i  sk2/a I  I j  obz/CLS_manhat/GRP_rnanhat/ JOB_manusemen/DI V_umchap8 

You  can  often  use  an  existing  form  as  a  model  for  making  a  new 
form.  Load  the  existing  form,  then  choose  the  Save  this  form  option 
and  save  the  form  with  the  name  you  want  for  the  new  form.  Any 
changes  you  now  make  to  the  form  on  the  design  screen  will  be  saved 
to  the  new  form,  and  the  original  will  be  left  intact. 


Edit  Description  of  Form 

You  use  this  option  to  change  the  catalog  description  of  the  form.  Simply 
change  the  existing  description  as  displayed  on  the  screen. 

Save  This  Form 

This  option  lets  you  save  the  current  form  under  its  present  name  or  under  a 
new  name.  If  you  save  it  under  a  new  name,  the  current  form  takes  on  the 
new  name  immediately. 

NOTE 

You  can  watch  dBASE  IV  generate  the  code  for  your  form  by  setting 
Instruct -ed?  ON  and  Ihlk  to  OFF. 

A 


The  Forms  Fields  Menu 


The  Fields  menu  lets  you  add, 
delete,  and  modify  fields  on  the 
forms  design  work  surface.  A  simi¬ 
lar  menu  appears  on  the  design 
screens  for  labels  and  reports. 

The  basic  Fields  menu  is  described  in  Chapter  9,  “Designing  Reports.”  On 
the  forms  design  screen,  three  basic  types  of  fields  are  available:  fields  from 
the  underlying  database  file  or  view,  calculated  fields,  and  memory  variable 
fields. 

Data  can  be  entered  with  a  form.  Therefore,  data-entry  picture  functions  are 
available  when  you  design  a  form.  You  can  also  assign  special  edit  options  to 
the  fields  on  a  form  and  specify  the  dimensions  you  want  for  each  memo 
field. 

Literal  colors  can  be  applied  to  forms  on  color  screens.  Borders  can  be  blue, 
for  example,  while  fields  that  are  read-only  can  be  yellow. 

Add  Field 

Use  this  option  to  add  fields  to  the  work  surface.  First  position  the  cursor 
where  you  want  the  new  field.  If  you  have  Insert  OFF,  be  careful  to  leave 
room  for  the  field  on  the  surface,  since  it  will  overwrite  whatever  is  on  the 
surface  where  it  is  being  placed. 
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Then  select  this  option,  and  a  two-column  list  displays.  The  first  column  con¬ 
tains  field  names  from  the  current  database  file  or  view.  If  this  underlying 
data  source  is  a  view  and  has  calculated  fields,  these  calculated  fields  are 
included  in  the  list. 

The  second  column  shows  the  field  names  of  any  calculated  fields  defined  so 
far  for  this  form.  You  can  choose  the  special  <  create  >  marker  at  the  top 
of  this  list  to  create  a  new  calculated  field. 

Adding  a  Field  from  the  Database  File  or  View 

After  you  choose  the  name  of  a  field  in  the  database  file  or  view,  the  Held 
description  menu  shown  in  Figure  8-3  appears. 


Figure  8-3  A  field  description  menu 


Use  this  menu  to  enter  information  about  the  field  you  want  to  place  on  the 
work  surface.  The  information  at  the  top  of  the  menu  (Field  name,  Type, 
Length,  and  Decimals)  comes  from  the  database  file  or  view  definition.  This 
information  cannot  be  modified  from  the  forms  design  screen. 

The  information  below  these  items  can  be  modified  from  this  screen.  You 
can  accept  the  suggestions  by  pressing  Ctrl-End,  or  modify  the  information 
presented.  You  can  also  abandon  this  process  by  pressing  Esc. 

The  information  in  the  validation  submenu  can  be  modified,  according  to 
the  description  in  the  “Specifying  Field  Templates,”  “Specifying  Picture 
Functions,”  and  “Specifying  Edit  Options”  sections  of  this  chapter. 

After  you  finish  modifying  the  information  and  press  Ctrl-End,  the  field  is 
placed  at  the  current  cursor  position. 
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Adding  a  New  Calculated  Field 

You  can  create  calculated  fields  when  you  define  a  view  with  a  view  query. 
You  can  also  create  calculated  fields  for  a  form. 

To  create  a  new  calculated  field,  choose  the  <  create >  marker  from  the 
CALCULATED  column  of  the  Add  field  submenu.  To  modify  one  of  the  cal¬ 
culated  fields  already  created  for  this  form,  choose  the  name  of  the  calcu¬ 
lated  field. 

A  validation  submenu  for  this  type  of  field  appears.  A  calculated  field  has 
special  options  in  its  validation  submenu,  as  shown  in  Figure  8-4. 


Figure  8-4  Validation  submenu  for  a  calculated  field 


Since  a  calculated  field  is  defined  only  for  the  forms  design  screen,  it  has  no 
pre-defined  attributes.  You  can  change  every  option  in  its  submenu. 

Use  the  Name  option  to  assign  a  name  to  the  calculated  field.  A  calculated 
field  does  not  need  a  name  bu  without  one,  it  cannot  be  used  in  expressions 
for  other  calculated  fields  and  will  not  appear  in  the  field  list  for  the  Modify 
field  and  Remove  field  options.  A  calculated  field  also  needs  a  name  if  you 
want  to  place  it  in  the  view. 

You  can  enter  up  to  80  characters  of  explanation  about  the  content  or  pur¬ 
pose  of  the  calculated  field  in  the  Description  option.  The  Expression  is  the 
actual  calculation  that  defines  the  field.  You  can  enter  any  dBASE  expres¬ 
sion,  including  memory  variable  names.  You  cannot  make  a  calculated  field 
without  an  expression.  You  cannot  use  a  calculated  field  defined  on  the  cur¬ 
rent  form  in  the  expression  of  another  calculated  field. 
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If  you  want  assistance  entering  the  expression,  press  Shift-FI  Pick  to  display 
the  names  of  the  fields  in  the  database  file  or  view,  along  with  possible  oper¬ 
ators  and  functions. 

Tb  finish  entering  the  expression,  press  *-*■.  The  expression  is  evaluated.  If  it 
relies  on  any  memory  variables,  these  must  already  be  defined. 

The  Template  option  is  described  in  this  chapter’s  “Specifying  Field 
Templates”  section.  The  Picture  functions  option  is  explained  in  this  chap¬ 
ter’s  “Specifying  Picture  Functions”  section. 

When  you  finish  entering  information  for  the  calculated  field,  press  Ctrl-End. 
The  calculated  field  will  be  placed  on  the  form. 

Specifying  Field  Templates 

The  Template  option  lets  you  customize  how  a  field  accepts  and  displays 
data.  (In  reports  and  labels,  you  can  specify  how  data  is  printed,  but  not  how 
it  is  entered.)  A  template  shows  the  width  of  a  field  and  the  type  of  charac¬ 
ters  expected  in  each  column. 

For  example,  you  might  want  to  write  a  template  for  a  phone  number  as 
(999)999-9999.  When  you  use  the  form  to  enter  data  for  this  field,  the  paren¬ 
theses  and  dash  will  appear  automatically  on  the  screen  and  only  numbers 
will  be  accepted. 

When  you  choose  the  Template  option,  a  box  on  the  screen  displays  the  tem¬ 
plate  characters  you  can  choose  for  the  current  field.  Forms  have  special 
template  characters  not  available  on  reports  and  labels.  These  template  char¬ 
acters  restrict  the  data  entered  in  their  column  as  shown. 

Y  Input  must  be  either  Y  or  N,  either  for  character  or  logical  field 
type 

L  Input  must  be  logical  T,  F,  Y,  or  N 

9  Input  must  be  digits  and  signs 

#  Input  must  be  digits,  blanks,  or  signs 

A  Input  must  be  letters 

N  Input  must  be  letters  or  digits 

IX  Input  can  be  any  character 

I  Convert  letters  to  uppei^fase 

The  Template  option  is  not  available  for  date  fields,  since  they  use  whatever 
date  format  is  in  effect  when  the  form  is  used.  You  can  change  the  way  dates 
are  displayed  with  the  Date  order  option  from  the  Settings  submenu  of  the 
Tools  menu.  The  date  format  can  also  be  changed  with  the  SET  DATE  TO 
command  at  the  dot  prompt. 

You  can  determine  the  appearance  of  the  data  inside  the  form’s  fields  by 
applying  options  from  the  Words  menu  to  the  field’s  template. 
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Specifying  Picture  Functions 

Choose  the  Picture  functions  option  to  indicate  the  attributes  you  want 
assigned  to  a  particular  field.  A  list  of  attributes  appears  on  the  screen,  and 
you  can  choose  one  or  more  of  them.  Press  CtrlgEnd  to  save  your  selection. 


Figure  8-5  Numeric  picture  functions 


The  picture  functions  for  numeric  fields  let  you  specify  how  you  want  num¬ 
bers  to  display.  The  function  of  these  template  options  is  indicated  by  the 
menu  option  names  and  the  messages  at  the  bottom  of  your  screen.  The 
Help  box  can  also  tell  you  about  each  option. 


Figure  8-6  Character  picture  functions 
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The  picture  functions  for  character  fields  let  you  specify  how  you  want  text 
to  display.  The  function  of  these  template  options  is  indicated  by  the  menu 
option  names,  the  message  line,  and  the  Help  box. 

Forms  have  three  picture  functions  useful  for  entering  data.  These  picture 
functions  are  not  available  for  reports  or  labels,  which  only  output  data. 

A  Alphabetic  characters  only 

R  Literals  not  part  of  data 

S  Scroll  within  display  width 

M  Multiple  choice 

flVhen  you 

choose  the  Multiple  choice  option,  you  are  asked  to  enter  the  choices  that 
should  be  offered  for  this  field.  Enter  choices,  separated  by  commas.  To  fin¬ 
ish  entering  choices,  press  •*-*  after  the  last  entry. 

For  further  information  about  specific  picture  functions,  check  the  @...SAY 
command  in  Language  Reference.  The  letters  to  the  right  of  the  option 
names  are  the  specific  dBASE  names  for  these  picture  functions. 

Edit  Options 

The  choices  on  the  Edit  options  menu  set  up  special  limits  for  what  values 
can  be  accepted.  Press  Ctr^End  to  save  your  choices. 


To  mark  fields  as  display -only,  set  the  Editing  allowed  option  to  NO.  This 
means  that  data  can  be  displayed  but  not  entered. 

You  can  also  make  fields  conditionally  read-only,  allowing  editing  only  if  cer¬ 
tain  conditions  are  met.  You  do  this  by  selecting  the  Permit  edit  if  option. 
When  you  select  this  option,  you  must  enter  a  dBASE  expression  to  be  evalu¬ 
ated  when  the  person  using  the  form  tries  to  place  the  cursor  in  the  field. 
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The  Message  option  lets  you  enter  a  message  to  display  whenever  a  user 
places  the  cursor  on  the  current  field. 

Carry  forward  uses  the  data  from  the  corresponding  field  in  the  previous 
record  when  you  add  a  new  record. 

Default  value  lets  you  specify  the  initial  data  that  appears  in  this  field  when 
you  add  a  new  record.  This  data  can  then  be  modified  if  necessary. 

Smallest  allowed  value  and  Largest  allowed  value  define  the  range  within 
which  new  values  must  fail.  If  a  value  outside  this  range  is  entered  into  a 
field,  that  value  is  not  accepted  and  a  message  appears  showing  the  accept¬ 
able  range. 

Accept  value  when  lets  you  supply  conditions  that  must  be  met  before 
new  data  will  be  accepted.  These  conditions  can  be  any  valid  dBASE  IV 
expression. 

Unaccepted  message  is  the  message  that  appears  when  the  Accept  value 
when  requirement  is  not  satisfied. 

You  may  enter  dBASE  IV  expressions  or  constants  for  these  options:  Default 
value,  Smallest  allowed  value,  and  Largest  allowed  value. 

Memo  Windows  and  Markers 

In  a  form,  memo  fields  can  be  expanded  into  memo  windows.  These  win¬ 
dows  are  usually  smaller  than  the  zoomed  full-screen  displays  of  memo 
fields.  Memo  windows  allow  you  to  edit  the  data  inside  memo  fields  without 
losing  the  context  of  the  rest  of  the  form. 


Memo  fields  can  initially  appear  on  a  form  either  as  memo  markers  or 
memo  windows.  A  memo  field  set  to  display  as  an  open  window  is  called  a 
static  window. 

Memo  markers  can  be  expanded  to  memo  windows  and  to  full-screen  dis¬ 
play.  Static  memo  windows  can  be  expanded  to  full-screen  display,  but  they 
can  never  be  reduced  to  memo  markers. 
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The  advantage  of  static  memo  windows  is  that  you  can  see  the  information 
they  contain  right  away.  This  can  significantly  improve  the  usefulness  of  your 
forms.  Static  memo  windows,  however,  take  up  more  space  on  the  screen 
than  memo  markers  and  may  slow  down  scrolling  through  forms. 

The  memo  field  marker  is  MEMO.  When  a  memo  field  is  empty,  the  marker 
is  in  lower  case  (memo).  This  distinction  saves  you  the  inconvenience  of 
opening  memo  markers  only  to  find  they  are  empty. 

Placing  Memo  Windows  on  a  Form 

On  the  forms  design  screen,  the  field  validation  menu  for  memo  fields  has 
two  extra  options,  Display  as  MARKER/ WINDOW  and  Border  lines.  These 
options  let  you  choose  whether  to  set  the  memo  field  to  appear  initially  as  a 
marker  or  window.  You  can  also  choose  the  type  of  border  for  the  memo 
window. 

After  you  have  completed  the  field  validation  menu,  the  cursor  returns  to  its 
most  recent  position  on  the  layout  surface.  You  then  position  the  cursor 
where  you  want  the  upper  left  corner  of  the  memo  window  to  appear  and 
press 

A  ghost  box  appears  to  show  you  the  shape  of  the  memo  window  as  you  posi¬ 
tion  it.  Place  the  cursor  where  you  want  the  lower  right  corner  of  the  memo 
window  to  appear  and  press 

If  you  choose  to  make  the  memo  field  a  static  memo  window,  a  finished 
memo  window  will  appear  where  the  ghost  box  was. 

If  you  choose  to  make  the  memo  field  a  marker,  the  cursor  moves  to  the 
upper  left  corner  of  the  memo  window.  The  memo  window  remains  on  the 
screen,  and  you  must  position  the  cursor  where  you  want  the  left  side  of  the 
memo  marker  to  appear.  When  you  press  the  memo  window  will  disap¬ 
pear,  and  the  marker  will  be  placed  at  the  cursor  location. 

Modifying  Memo  Fields 

Static  memo  windows  can  be  deleted,  copied,  moved,  or  sized.  Memo  mark¬ 
ers  can  be  deleted,  copied,  or  moved,  but  they  cannot  be  sized  (since  they 
always  have  the  same  dimensions). 

You  can  position  the  size  and  location  of  the  memo  window  that  will  open 
when  you  eventually  use  a  memo  field.  To  do  this,  temporarily  display  the 
memo  window  on  the  forms  design  screen  by  placing  the  cursor  on  the 
marker  and  pressing  Ctrl-Home.  You  will  see  a  temporary  image  of  the  memo 
window  with  the  cursor  placed  at  the  top  left  corner. 

You  can  then  use  F7  Move  to  move  or  Shift-F7  Size  to  size  this  temporary 
window,  as  if  it  were  a  static  memo  window.  If  you  move  off  the  border  of 
the  temporary  image  without  first  pressing  F7  Move  or  Shift-F7  Size, 
dBASE  IV  beeps  once  and  the  image  automatically  shrinks  down  to  a  memo 
marker. 
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c  Styling  Memo  Fields 

Acolor  or  text  styling  of  a  memo  field  marker  or  window  on  the  forms 
design  work  surface  only  applies  to  the  way  the  memo  field  marker  or  win¬ 
dow  displays.  The  text  inside  the  memo  field  is  not  affected. 

Remove  Field 

You  can  use  this  option  to  remove  a  field  from  the  work  surface.  If  the  cur¬ 
sor  is  positioned  on  a  field,  that  field  will  be  removed.  If  the  cursor  is  not 
positioned  on  a  field,  you  can  pick  the  name  of  a  field  from  a  list  of  all  the 
fields  currently  on  the  work  surface. 


Modify  Field 

You  can  use  this  option  to  change  the  options  in  the  field  description  menu 
for  a  field.  A  shortcut  to  this  option  is  to  press  F5  Field. 

If  the  cursor  is  positioned  on  a  field,  that  field  will  be  the  one  modified.  If 
the  cursor  is  not  positioned  on  a  field,  you  can  pick  the  name  of  a  field  from 
a  list  of  all  the  fields  on  the  work  surface.  Only  the  current  placement  of  the 
field  is  modified,  even  if  you  have  several  copies  of  field  on  the  work  surface. 

You  can  also  modify  the  current  field  by  pressing  Ctrl-Home. 

Insert  Memory  Variable 

This  option  lets  you  place  a  memory  variable  on  the  form.  It  is  especially 
useful  for  data  contained  in  SQL  databases,  so  you  can  create  forms  that  rely 
on  memory  variables  instead  of  fields. 

Choose  the  Insert  memory  variable  option  and  adjust  the  menu  entries  to 
your  needs.  You  can  change  the  memory  variable  type  by  pressing  Spacebar 
or  Press  Ctrl-End  to  finish. 


Other  Menus 

Several  of  the  menus  on  the  forms  design  screen  are  repeated  elsewhere  in 
dBASE  IV.  The  Words  menu  is  described  in  Chapter  4,  “Editing.”  The 
Go  To  menu  is  described  in  Chapter  3,  “Browse  and  Edit.”  The  Exit  menus 
are  described  in  Chapter  9,  “Designing  Reports.” 
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Designing 
Reports  ' 


Introduction  to  Reports 


You  use  reports  to  print  the  data  you  have  stored  in  dBASE  IV.  Reports  help 
you  send  data  to  your  printer,  but  their  major  value  comes  from  their  ability 
to: 

■  Group  related  data  together 

■  Print  fields  where  you  want  them 

■  Handle  pagination  chores  automatically 

■  Perform  arithmetic  and  statistical  operations  on  data 

■  Insert  field  data  into  standard  text 

With  these  capabilities,  you  can  design  reports  that  group  sales  figures  by 
region  and  salesperson.  You  can  print  form  letters  filled  with  customized 
information  about  clients.  You  can  even  add  your  own  specific  data  to  pre¬ 
printed  forms. 

This  chapter  primarily  shows  you  how  to  design  reports  by  working  with 
fields  and  bands.  Techniques  for  using  the  layout  and  word  wrap  editing  sur¬ 
faces  are  described  in  Chapter  4,  “Editing.” 


Printing  Reports 

When  you  have  finished  designing  a  report,  you  can  use  the  options  on  the 
Print<m£jui)of  the  reports  menu  bar  to  print  the  report.  You  can  read  how 
to  use  the  Print  menu  in  Chapter  5,  “Printing.” 

You  can  also  print  reports  from  the  Control  Center  by  placing  the  cursor  on 
the  name  of  a  report  in  the  Control  Center’s  Reports  panel.  When  you  press 
— ,  the  Print  menu  appears  if  SET  INSTRUCT  is  OFF.  If  SET  INSTRUCT  is 
ON,  the  panel  prompt  box  displays.  Choose  the  Print  report  button,  and  the 
Print  menu  will  appear. 

You  can  make  Quick  Reports  by  pressing  Shift-F9  Quick  Report  from  the 
Control  Center,  or  the  reports  design  screen.  If  you  are  on  the  reports  design 
screen,  Quick  Report  uses  the  report  you  are  designing. 

From  the  Control  Center,  Quick  Report  uses  the  same  format  as  the  Column 
layout  option  from  the  Layout  menu’s  Quick  layout  option. 
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That  format  prints  every  field  in  the  database  file  or  view,  using  field  names 
for  column  headings.  Asum  for  every  numeric  field  appears  in  the  report’s 
summary  band,  and  page  numbers  and  the  current  date  are  placed  in  the 
page  headers. 

Quick  Report  is  not  available  from  the  design  screens  for  reports,  labels,  or 
forms. 

From  the  dot  prompt,  you  can  print  a  report  by  entering  REPORT  FORM 
<  report  name>  TO  PRINTER.  In  this  case,  the  Print  menu  will  not  dis¬ 
play,  and  the  report  will  be  printed  directly. 


Reaching  the  Reports  Design  Screen 

You  can  reach  the  reports  design  screen  from  the  Control  Center  or  the  dot 
prompt. 

From  the  Control  Center,  to  design  a  new  report,  choose  the  <  create  > 
marker  in  the  Reports  panel.  To  modify  an  existing  report,  place  the  cursor 
on  the  name  of  the  report  in  the  Control  Center’s  Reports  panel.  If  SET 
INSTRUCT  is  ON,  press  and  the  panel  prompt  box  will  display.  Choose 
the  Modify  layout  button,  press  and  the  reports  design  screen  appears. 


NOTE 

If  you  choose  Display  data,  the  Browse/Edit  screen  displays  the  data 
in  the  database  file  or  view  that  will  be  used  by  the  report.  If  the  cur¬ 
rent  database  file  or  view  is  not  the  one  normally  associated  with  the 
report,  you  may  choose  between  the  current  database  file  or  view  and 
the  one  normally  associated  with  the  report. 


If  SET  INSTRUCT  is  OFF,  press  Shift-F2  Design,  and  the  reports  design 
screen  will  appear.  Shift-F2  Design  is  the  shortcut  to  the  design  screen  and 
always  works,  no  matter  whether  SET  INSTRUCT  is  ON  or  OFF. 

From  the  dot  prompt,  you  reach  the  reports  design  screen  by  entering 
CREATE  REPORT  <  report  nrme>  or  MODIFY  REPORT  <  report  name>  . 

Design  Elements  of  Reports 

When  you  design  a  report,  you  can  work  with  several  design  elements: 

■  Fields  from  the  current  database  file  or  view 

■  Special  fields  you  create  just  for  the  report 

■  Text  typed  in  on  the  reports  design  work  surface 

■  Boxes  and  lines  you  draw  on  the  reports  design  work  surface 

All  these  specific  elements  are  placed  on  the  reports  design  work  surface. 
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Figure  9-1  Report  design  screen 

The  reports  design  work  surface  uses  report  bands.  These  bands  divide  the 
report  into  different  logical  pieces,  so  you  can  see  more  of  your  report  on 
the  screen  at  one  time.  Bands  also  show  how  the  parts  of  a  report  are  related 
to  each  other. 


Using  the  Reports  Design  Work  Surface 

Designing  a  report  means  using  one  of  dBASE  IV’s  two  editing  modes. 

The  word  wrap  mode  behaves  like  a  typical  word  processor,  treating  text  as 
one  long  string  of  characters.  It  is  useful  for  creating  introductory  explana¬ 
tions  for  the  data  in  a  report.  You  can  also  use  word  wrap  mode  to  create 
form  letters. 

The  layout  editing  mode  works  more  like  a  bulletin  board.  You  can  place 
fields  on  the  layout  surface,  then  move  them  around  from  place  to  place. 
Layout  mode  is  useful  for  adding  fields,  boxes,  and  lines  to  the  report. 

The  word  wrap  and  layout  modes  are  described  more  in  Chapter  4, 
“Editing.” 
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The  Basic  Bands 

Figure  9-1  shows  a  typical  reports  design  work  surface.  The  horizontal  lines 
indicate  the  borders  of  the  report  bands.  When  you  first  create  a  report,  the 
following  bands  appear  automatically: 

■  Page  Header 

■  Report  Intro 

■  Detail 

■  Report  Summary 

■  Page  Footer 

The  space  on  the  work  surface  between  the  line  labeled  Page  Header  Band 
and  the  line  labeled  Report  Intro  Band  contains  the  information  for  the 
page  header.  The  page  header  is  the  space  at  the  top  of  each  page  that  typi¬ 
cally  contains  information  such  as  the  page  number  and  date.  As  you  will 
see,  it  can  also  contain  the  titles  for  your  columns  of  data. 

The  page  footer  serves  a  similar  purpose  to  the  page  header.  You  could,  for 
example,  place  the  name  of  your  department  or  a  running  title  for  the  report 
at  the  bottom  of  each  page. 

The  report  intro  contains  material  that  appears  at  the  beginning  of  the  report. 
For  example,  you  might  start  a  report  with  a  cover  letter  explaining  the  data 
that  follows. 

The  report  summary  contains  information  that  appears  at  the  end  of  the 
report.  This  is  the  place  to  add  concluding  remarks  or  show  final  totals. 

The  detail  band  shows  the  data  from  the  records  in  the  database  file  or  view. 
For  example,  you  might  show  the  names  of  all  salespeople,  along  with  their 
monthly  sales  targets  and  actual  orders. 

The  detail  band  is  different  from  the  other  bands  because  its  contents  are 
repeated  for  every  record  in  the  database  file  or  view.  The  detail  band  can 
contain  this  repeating  information  in  many  ways,  from  simple  columns  of 
data  to  a  complete  form  letter. 
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The  layout  Is... 
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Page  Header  Band  ■  ■ 
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1 1  :59 :34  am 


xxxxxxxxx*xxxxxx*xxxxxxxxxxxxl 
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Figure  9-2  A  detail  band  on  the  work  surface  and  the  printed  report 

A  band  can  use  either  the  word  wrap  or  layout  mode,  but  not  both  at  the 
same  time.  You  might,  for  example,  choose  to  use  the  layout  mode  in  a  detail 
band,  but  use  the  word  wrap  mode  to  design  the  report  intro  band. 

There  are  two  ways  to  tell  which  band  the  cursor  is  in.  Obviously,  you  can 
look  at  the  cursor  itself.  In  addition,  you  can  check  the  status  line  at  the  bot¬ 
tom  of  the  screen.  If  the  cursor  is  on  a  band  border,  the  third  section  of  the 
status  bar  shows  the  number  of  the  band  and  the  total  number  of  bands  in 
the  report. 

In  Figure  9-1,  for  example,  the  report  has  a  total  of  five  bands  and  the  cursor 
is  on  the  border  for  the  report  intro  band.  The  status  bar  therefore  shows  the 
cursor’s  location  as  Band  2/5. 

Group  Bands 

Besides  the  basic  bands,  which  are  always  part  of  the  report,  you  can  add 
group  bands  to  the  work  surface.  Group  bands  organize  records  in  the  report 
by  collecting  them  into  groups.  A  group  is  defined  by  one  of  three  qualities: 
record  count,  field  value,  or  dBASE  IV  expression. 
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You  can  ask  for  a  new  group  every  so  many  records,  say,  every  25  records.  A 
new  group  can  also  start  every  time  the  value  in  some  field  changes.  You 
might  start  a  new  group  every  time  information  in  the  City  field  changes,  for 
example.  Finally,  you  can  form  groups  by  applying  dBASE  IV  expressions. 

For  example,  you  could  form  groups  of  people  who  share  the  first  three  dig¬ 
its  in  their  zip  codes. 

For  reports  to  work  properly,  you  need  to  index  (or  sort)  the  records  in  rela¬ 
tion  to  the  grouping.  For  example,  if  you  index  a  name  and  address  file  by 
City  +  Lastname,  you  could  then  group  on  LEFT(Lastname,l).  This  would 
produce  a  report  in  order  of  city,  with  all  the  last  names  beginning  with  A 
separated  from  the  last  names  beginning  with  B.  If  the  file  is  not  indexed  (or 
sorted),  you  could  end  up  with  a  different  group  for  each  person. 

One  of  the  major  reasons  for  grouping  the  records  in  a  report  is  to  show  sub¬ 
totals.  You  can  also  apply  statistical  functions  to  the  members  of  the  group. 
You  could,  for  example,  show  the  average  salary  for  all  the  people  in  Chi¬ 
cago  whose  last  name  begins  with  A 

Parts  of  a  Group  Band 

Each  group  band  is  really  two  bands,  the  group’s  intro  band  and  the  group’s 
summary  band.  Group  intro  bands  may  contain  headings  for  the  columns  of 
information  below.  They  can  also  display  titles  to  clarify  the  grouping  plan. 

When  printed,  group  intro  bands  contain  information  that  remains  constant 
combined  with  information  that  changes,  depending  on  the  data  in  the  data¬ 
base  file.  For  example,  in  the  situation  described  above,  one  group  intro 
might  print  as  Name  of  city:  Princeton ,  while  the  next  group  intro  prints  as 
Name  of  city:  Prospect  Heights. 

A  report  can  both  calculate  and  display  statistical  information  for  each 
group.  This  information  is  shown  in  the  group  summary  band.  Possible 
summary  functions  are: 

Average 

Count 

Maximum 

Minimum 

Sum 

Standard  deviation 
Variance 
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Figure  9-3  A  group  intro  and  summary 

Adding  Group  Bands 

Sometimes  you  may  want  to  make  groupings  within  groupings.  For  example, 
you  may  need  to  group  sales  records  by  county,  then  by  city.  To  do  this, 
make  a  subgroup  on  City,  inside  the  major  group  by  County.  This  is  called 
nesting  groups. 

You  add  a  new  group  by  choosing  the  Add  a  group  band  option  from  the 
Bands  menu.  Groups  are  added  inside  (below)  the  current  band.  To  create  a 
group  outside  an  existing  group,  place  the  cursor  above  the  existing  group’s 
intro  band  before  choosing  the  Add  a  group  band  option. 


Figure  9-4  State  and  City  group  bands 
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In  Figure  9-4,  the  cursor  is  inside  the  State  group’s  intro  band.  To  add  a 
new  band  that  groups  on  County,  you  could  choose  the  Add  a  group  band 
option.  The  screen  would  then  look  like  the  one  in  Figure  9-5.  You  could  add 
the  relevant  fields  and  text  to  complete  this  new  band  grouped  on  County. 

Notice  that  the  groups  have  been  renumbered.  The  City  band  is  now  Group 
3.  When  you  add  or  remove  groups,  the  current  groups  are  automatically 
renumbered  from  top  to  bottom. 


Figure  9-5  State,  County,  and  City  group  bands 

The  detail  line  remains  the  kernel  of  the  report,  and  all  groups  are  nested 
around  it.  For  this  reason,  you  cannot  add  a  group  when  the  cursor  is  on  the 
detail  line,  since  no  group  can  be  placed  inside  the  detail  band. 

Removing  Group  Bands 

You  delete  the  current  grouo  by  selecting  the  Remove  group  option.  You 
will  be  asked  to  confirm  your  choice,  then  both  the  group  intro  and  sum¬ 
mary  bands  will  be  removed  from  the  report. 

You  can  also  delete  a  group  by  placing  the  cursor  on  the  border  of  its  intro 
band  or  summary  band.  Pressing  Del  and  confirming  your  choice  will  also 
delete  the  intro  and  summary  band  for  that  group. 

Opening  and  Closing  Bands 

You  may  want  to  close  some  group  bands  to  make  it  easier  to  concentrate  on 
one  band  at  a  time.  Place  the  cursor  on  the  border  line  of  a  band  and  press 
This  will  close  an  open  band  or  open  a  closed  band. 

When  you  print  reports,  only  the  open  bands  print.  This  lets  you  design  com¬ 
plex  reports  from  which  you  can  print  just  the  amount  of  detail  you  need. 
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■ra  tip 

7b  repeat  column  headings  at  the  top  of  a  page  even  though  the  group 
does  not  break  there,  put  the  column  headings  in  a  nested  subgroup. 
Qroup  this  subgroup  on  the  same  value  as  the  group  and  choose  the 

'tiroup  intro  on  each  pagc'oftllA'n  ffli1  The TjufTgroup.  The  columrTj 


ui 
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eadings  will  then  print  at  the  top  of  each  page. 


The  layout  is... 


Group  1  Intro  Band - - - — — - - — 

Below  are  the  monthlu  sales  of  each  item  for  XXXXXXXXXXXXXU 


Group  2  Intro 


Roport  Summary  Bawd 


-By  state 

-By  state,  with 

Repeat  group 
intro  on  each 

page  attribute 


The  printout  Is... 


Vldgets 
Dec  $95,000 


Below  are  th 
for  NEV  JERi 

Vidgets 
Jan  $10,000 
Feb  $15,000 


Widgets  Fidgets  Goos  Gahs 
Jan  $10,000  $30,000  $25,000  $90,000 
Feb  $15,000  $19,000  $38,000  $19,292 


Figure  9-6  Using  the  same  value  for  nested  groups 


Suggestions  for  Printing  Reports 

Only  open  bands  print.  If  you  want  to  print  only  selected  portions  of  a 
report,  close  the  bands  you  do  not  want  printed. 

To  make  your  reports  clearer,  dBASE  IV  begins  a  new  page  when  the  data 
from  a  single  record  might  be  split  between  the  bottom  of  one  page  and  the 
top  of  the  next.  You  can  change  this  minimum  number  of  lines  by  the 
amount  of  lines  you  allow  in  the  detail  band  on  the  reports  design  screen. 
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For  example,  suppose  you  want  to  print  a  memo  field  with  vertical  stretch, 
and  only  a  few  of  your  memo  fields  will  take  up  more  than  five  lines.  You 
could  add  four  blank  lines  below  the  memo  field  in  the  detail  band.  Then 
dBASE  IV  will  keep  most  of  your  memo  fields  intact,  starting  a  new  page  if 
necessary. 

(Any  memo  fields  that  are  taller  than  five  lines  still  run  the  risk  of  being  split 
between  the  bottom  of  one  page  and  the  top  of  the  next.) 

You  can  view  a  report  on  the  screen  before  printing  it.  If  the  report  is  wider 
than  the  screen,  the  text  will  wrap  to  the  next  line.  To  display  the  next 
screenful,  press  any  key.  To  cancel  the  display  of  a  report,  press  Esc. 

You  can  save  print  settings  to  a  print  form  and  apply  these  settings  later. 
Whenever  you  save  a  report,  dBASE  IV  remembers  the  name  of  the  current 
print  form,  then  uses  this  print  form  the  next  time  you  print  the  report.  If 
you  want  to  change  the  print  form  a  report  uses,  load  the  report,  make  the 
desired  print  form  current,  and  save  the  report. 


Using  the  Reports  Menu  Bar 

The  reports  screen  has  seven  menus:  Layout,  Fields,  Bands,  Words,  Go  To, 
Print,  and  Exit.  The  Words  menu  is  described  in  Chapter  4,  “Editing.”  The 
Go  To  menu  is  explained  in  Chapter  3,  “Browse  and  Edit.”  The  Print  menu 
is  presented  in  Chapter  5,  “Printing.” 

The  Layout  Menu 

When  you  choose  the  <  create  > 
option  from  the  Reports  panel  of 
the  Control  Center,  the  reports 
design  screen  appears,  with  the 
cursor  positioned  on  the  Quick 
layout  option  of  the  Layout  menu. 


Quick  Layout 

The  Quick  layout  option  gives  you  three  types  of  automatic  report  designs: 

Column  layout,  Form  layout,  and  MailMerge  layout. 

Column  Layout 

Column  layout  is  the  same  as  the  Quick  Report  layout.  All  fields  in  the  cur¬ 
rent  view  are  placed  in  a  row,  with  each  field’s  name  placed  above  its  tem¬ 
plate  as  a  column  heading.  Numeric  fields  have  summary  fields  placed  below 
them  in  the  report  summary  band.  The  page  number  and  date  are  placed  in 
the  page  header  band. 
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Once  this  layout  has  been  placed  on  the  work  surface,  you  can  remove  the 
templates  of  any  fields  you  don’t  want  in  the  report.  Either  choose  the 
Remove  field  option  or  press  Del  when  the  cursor  is  placed  on  the  field  you 
want  to  remove. 

You  can  then  use  F7  Move  to  place  the  remaining  fields  in  any  desired  posi¬ 
tion  on  the  work  surface. 

Form  Layout 

This  option  creates  a  layout  that  resembles  the  basic  Edit  layout  of 
dBASE  IV.  The  name  of  each  field  in  the  supporting  database  file  or  view 
appears  on  its  own  line,  flush  left,  followed  by  the  field’s  template.  The  page 
number  and  date  are  placed  in  the  page  header  band. 

In  both  column  layout  and  form  layout,  the  report  intro  band  is  closed  and 
the  detail  ba^?3  begins  with  a  blank  line. 

MailMerge  Layout 

MailMcrge  layout  helps  you  use  reports  to  print  form  letters. 


Figure  9-7  The  MailMerge  layout 

In  this  layout,  all  the  bands  except  the  detail  band  are  closed.  The  detail 
band  has  both  the  Word  wrap  and  Begin  band  on  new  page  attributes,  and 
the  cursor  is  placed  in  the  upper  left  corner  of  the  detail  band. 

Each  field  also  has  the  Horizontal  stretch  picture  function,  so  the  text  you 
place  on  the  work  surface  will  correctly  flow  around  any  names  or  custom¬ 
ized  information. 

Box 

This  option  draws  a  box  on  the  work  surface.  It  is  described  in  Chapter  8, 
“Designing  Forms.” 
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Line 

This  option  helps  you  draw  lines  on  the  work  surface.  It  is  described  in 
Chapter  8,  “Designing  Forms.” 

Use  Different  Database  File  or  View 

This  option  allows  you  to  use  a  different  database  file  or  view  with  an  exist¬ 
ing  report.  This  works  best  if  the  old  and  new  data  sources  have  the  same 
field  names  and  structure.  You  can  use  a  database  file  or  view  that  has  a  dif¬ 
ferent  structure  as  long  as  it  contains  the  fields  needed  by  the  report. 

If  the  new  database  file  does  not  have  all  the  fields  needed  by  the  report,  a 
box  on  the  screen  tells  you  which  fields  are  missing. 

You  can  temporarily  use  a  different  database  file  or  view  with  the  report  by 
using  this  option  without  saving  the  report.  Only  when  you  save  the  report  is 
the  new  database  file  or  view  officially  assigned  to  it. 


Edit  Description  of  Report 

This  option  lets  you  change  the  catalog  description  for  this  report. 


Save  this  Report 

Use  this  option  to  save  the  data  in  the  current  report  if  you  plan  to  keep 
working  on  it.  This  prudent  step  may  save  you  hours  of  work  if  you  have  a 
power  failure  or  some  other  electronic  problem. 

Whenever  you  save  a  report,  you  are  associating  that  report  with  the  current 
database  file  or  view  and  the  current  print  form  file.  The  next  time  you  run 
the  report,  you  can  apply  it  to  the  database  file  or  view  current  at  the  time. 
You  can  also  use  the  normally  associated  database  file  or  view. 

You  may  assign  a  new  name  to  the  report  when  you  save  it. 


NOTE 

You  can  watch  dBASE  IV generate  the  code  for  a  report  by  setting 
Instruct  to  ON  and  Th Ik  to  OFF. 


The  Reids  Menu 


The  Fields  menu  helps  you  add  or 
remove  fields  on  the  report  design 
surface. 


You  can  place  four  types  of  fields  on  the  reports  design  work  surface. 

■  Fields  from  the  underlying  database  file  or  view 

■  New  calculated  fields  created  for  this  report 

■  Special  predefined  fields 

■  Summary  fields 


9-12 


DESIGNING  REPORTS 


PAGE:  13  SESS:  7  Fr  i  (lay  20  14:38:53  1988 
sk2/al I J obz/CLS_manha t /GRP_manha t / JOBjnanu semen/D I V_umchap9 

Add  Field 

Use  this  option  to  add  fields  to  the  work  surface.  First  position  the  cursor 
where  you  want  the  new  field  to  be  placed. 

When  you  select  this  option,  a  four-column  list  displays.  The  first  column 
contains  the  field  names  from  the  current  database  file  or  view.  If  the  data 
source  is  a  view  with  calculated  fields,  these  calculated  fields  are  also 
included  in  the  first  column. 

The  second  column  shows  the  field  names  of  any  calculated  fields  defined  so 
far  for  this  report.  You  can  choose  the  <  create >  marker  at  the  top  of  this 
list  to  create  a  new  calculated  field.  To  move  between  these  columns,  press 
*-  or 

The  third  column  contains  the  names  of  four  special  fields:  Date,  Time, 
Rccno,  and  Pagcno.  These  are  predefined  fields,  and  their  names  are  always 
the  same.  When  the  report  is  printed,  these  fields  will  show  the  current  date, 
time,  page  number,  and  record  number. 

The  fourth  column  holds  generic  names  for  the  seven  summary  fields,  fol¬ 
lowed  by  the  specific  names  for  fields  already  defined  for  this  report. 

The  summary  fields  are  Average,  Count,  Max,  Min,  Sum,  Std,  and  Var.  For 
any  group,  these  summary  fields  calculate  respectively  the  average  value  of  a 
field  in  the  group,  the  number  of  records  in  the  group,  the  maximum  or 
minimum  value  of  a  field  in  the  group,  the  sum  of  all  the  values  in  a  field, 
and  the  standard  deviation  and  variance. 

Adding  a  Field  from  the  Database  File  or  View 

After  you  choose  the  name  of  a  field  in  the  database  file  or  view,  the  field 
definition  menu  shown  in  Figure  9-8  appears. 
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Use  this  submenu  to  enter  information  about  the  field  you  want  to  place  on 
the  work  surface.  The  information  at  the  top  of  the  box  in  Figure  9-8  (Field 
name.  Type,  Length,  and  Decimals)  comes  from  the  database  file  or  view 
definition.  This  information  cannot  be  modified  from  the  reports  design 
screen. 

The  information  below  these  items  can  be  modified  from  this  screen.  You 
can  accept  the  suggestions  by  pressing  Ctri-End,  or  modify  the  information 
presented.  You  can  also  abandon  this  process  by  pressing  Esc. 

The  information  in  the  field  definition  menu  can  be  modified,  according  to 
the  description  in  the  “Specifying  Field  Templates”  and  “Specifying  Picture 
Functions”  sections  of  this  chapter. 

After  you  finish  modifying  the  information,  press  Ctri-End.  The  field  will  be 
placed  at  the  current  cursor  position. 


M  WARNING 

If  you  have  Insert  off,  make  sure  you  have  enough  room  for  the  field 
on  the  layout  surface  before  choosing  the  Add  field  option.  The  field 
template  will  write  over  anything  in  its  way  whenever  Insert  is  off. 


Adding  a  New  Calculated  Field 

You  can  create  calculated  fields  when  you  define  a  view  with  a  view  query. 
You  can  also  create  calculated  fields  for  a  report. 

To  create  a  new  calculated  field  for  the  report,  choose  the  <  create  > 
marker.  To  modify  any  calculated  field  already  created  for  this  report,  choose 
its  name  from  the  list.  Afield  definition  menu  for  calculated  fields  appears. 

This  menu  includes  an  option  called  Expression.  You  must  enter  a  valid 
dBASE  IV  expression  in  order  to  define  a  calculated  field.  By  pressing 
Sh'rft-FI  Pick,  you  can  display  a  list  of  field  names,  operators,  and  functions 
to  help  you  create  an  accurate  dBASE  IV  expression.  You  can  also  just  type 
in  the  expression  directly. 

This  expression  may  include  memory  variables,  but  they  must  already  be 
defined.  If  they  are  not  defined,  dBASE  IV  displays  an  error  message. 

After  you  have  entered  the  information  for  this  field,  press  Ctri-End. 

You  can  make  calculated  and  summary  fields  hidden.  This  means  you  can 
use  them  to  perform  calculations,  but  they  won’t  appear  on  the  reports 
design  screen  or  the  printed  report. 

All  hidden  fields  require  names,  which  appear  on  the  list  of  fields  that  dis¬ 
plays  when  you  ask  to  modify  or  delete  a  field.  Once  a  field  is  hidden,  you 
can  display  it  again  by  modifying  the  field’s  field  definition  menu,  changing 
Hidden  to  NO.  You  can  also  use  the  Change  hidden  field  option  described 
below . 
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Adding  a  Predefined  Field 

Predefined  fields  are  special  fields  that  display  the  current  date,  time,  page 
number,  or  record  number.  After  you  choose  the  field  you  want  from  the 
SUMMARY  list,  fill  in  the  field  definition  menu  that  appears.  When  you 
press  Ctrl-End,  the  field  is  placed  on  the  work  surface. 

You  can  change  the  type  of  a  predefined  field  by  choosing  the  Name  option 
and  pressing  until  the  type  of  field  you  want  is  displayed. 

Adding  a  Summary  Field 

When  you  add  a  summary  field,  you  can  choose  either  a  generic  summary 
field  name  or  the  specific  name  of  an  existing  summary  field.  After  you 
choose  a  field,  a  field  definition  menu  appears.  Fill  in  the  field  definition 
menu,  and  press  Ctrl-End. 

The  Operation  option  calls  up  a  list  of  the  seven  generic  summary  field 
names.  This  gives  you  the  opportunity  to  change  the  type  of  the  summary 
field. 

The  Field  to  summarize  on  option  displays  a  list  of  fields.  If  you  have 
defined  any  calculated  fields  for  this  report,  the  list  has  two  columns.  The 
first  column  contains  fields  from  the  underlying  database  file  or  view,  while 
the  second  column  displays  any  calculated  fields^created  for  the  report. 

The  Reset  every  option  lets  you  reset  the  current  summary  field  to  zero  at 
specified  points  in  the  report.  To  change  this  option,  press  •*-►.  A  list  of 
choices  will  appear  on  your  screen. 

Reset  every  <  PAGE>  sets  the  summary  field  to  zero  for  each  new  page. 
This  is  useful,  for  example,  if  you  want  to  count  the  number  of  records  on 
each  page. 

Reset  every  <  REPORT>  actually  resets  the  summary  field  only  at  the  end 
of  the  report,  which  is  equivalent  to  not  resetting  it  at  all.  This  is  the  default 
choice. 

Resetting  by  Group 

You  can  also  reset  a  summary  field  every  time  a  new  group  begins.  The  list 
of  choices  on  the  screen  displays  the  field  names,  expressions,  or  record 
counts  used  to  form  all  the  groups  in  your  report.  Choose  the  item  that 
describes  the  group  for  which  you  want  the  summary  field  reset.  For  exam¬ 
ple,  if  you  are  grouping  by  state,  you  might  want  to  reset  a  summary  field  to 
zero  each  time  a  new  state  is  reached. 

Summary  fields  work  with  the  data  encountered  as  a  report  is  printed.  This 
data  comes  from  the  repeating  fields  in  the  report’s  detail  band.  For  this  rea¬ 
son,  summary  fields  should  only  be  placed  in  or  below  the  detail  band.  If  a 
summary  field  is  placed  in  an  intro  band,  it  will  have  no  data  to  summarize. 

Summary  fields  are  first  calculated  in  the  detail  band.  Then  they  are  calcu¬ 
lated  in  the  highest  numbered  band,  the  next  highest  numbered,  and  so 
forth.  In  other  words,  summary  fields  are  calculated  from  the  detail  band 
outwards. 
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This  means  that  the  reset  values  for  summary  bands  should  be  chosen  care¬ 
fully.  The  most  common  choices  are  to  reset  every  page  or  by  the  same  field 
or  record  count  as  the  band  containing  the  summary  field.  If  you  want  to 
reset  by  a  grouping  definition  used  by  some  other  group,  you  should  choose 
from  those  groups  that  contain  the  current  group. 

For  example,  if  Group  1  is  based  on  Country,  Group  2  is  based  on  State,  and 
Group  3  is  based  on  County,  a  summary  field  in  the  Group  2  (State) 
summary  band  would  not  be  very  useful  if  it  reset  every  county  (Group  3). 

This  is  because  by  the  time  the  report  reaches  the  State  summary  band,  it 
will  have  already  cycled  through  all  the  state’s  counties.  Asummary  field  in 
the  State  summary  band  that  resets  every  county  could  be  deceptive,  particu¬ 
larly  if  two  states  share  county  names  (as  Pennsylvania  and  Virginia  do  York 
County). 

Specifying  Field  Templates 

The  field  definition  menus  contain  an  option  called  Template.  The  template 
is  the  stylized  representation  of  a  field  on  the  work  surface.  A  template 
shows  the  width  of  a  field  and  the  type  of  characters  expected  in  each 
column. 

When  you  choose  the  Template  option  from  a  field  definition  menu,  you  can 
edit  the  template  for  the  field  directly. 

You  can  style  the  data  inside  a  field  by  applying  options  from  the  Words 
menu  to  the  field’s  template.  On  the  forms  design  screen,  you  can  style  data 
with  the  Display  option.  On  the  reports  and  labels  screens,  use  the  Style 
option. 

If  you  are  adding  or  modifying  a  date  field,  the  Template  option  is  dimmed 
and  unavailable.  This  is  because  date  fields  use  the  setting  in  effect  when  a 
report  is  printed.  You  can  change  this  setting  with  the  Date  order  option  on 
the  Settings  menu  from  the  Tools  menu.  You  can  also  change  this  setting  in 
several  other  ways,  as  described  in  the  “Customizing  dBASE  IV”  section  of 
Language  Reference. 
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Specifying  Picture  Functions 

Choose  the  Picture  functions  option  to  indicate  the  attributes  you  want 
assigned  to  a  particular  field.  A  list  of  attributes  appears  on  the  screen,  and 
you  can  choose  one  or  more  of  them. 


Figure  9-9  Numeric  picture  functions 


The  picture  functions  for  numeric  fields  let  you  specify  how  you  want  num¬ 
bers  to  be  displayed.  The  function  of  these  options  is  indicated  by  the  menu 
option  names. 


Figure  9-1 0  Character  picture  functions 


The  picture  functions  for  character  fields  let  you  specify  how  you  want  text 
to  be  displayed.  The  function  of  these  options  is  indicated  by  the  menu 
option  names. 
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For  further  information  about  specific  picture  functions,  check  the  @|...'1>AY 
command  in  Language  Reference.  The  letters  to  the  right  of  the  option 
names  are  the  specific  dBASE  IV  codes  for  these  picture  functions. 

The  Horizontal  Stretch  and  Vertical  Stretch  picture  functions  are 
especially  important  for  reports.  They  allow  the  data  inside  a  field  to  deter¬ 
mine  the  width  or  height  of  the  field  when  it  is  printed. 

Horizontal  stretch  expands  or  contracts  a  field’s  width  to  adjust  to  the  size 
of  a  field.  Vertical  stretch  lets  the  data  in  a  field  wrap  down  the  page,  inside 
the  width  indicated  by  the  field’s  template.  Memo  fields  in  layout  bands  will 
initially  have  the  vertical  stretch  attribute,  while  memo  fields  in  word  wrap 
bands  will  initially  have  the  horizontal  stretch  attribute.  You  can  modify 
these  for  any  field  you  want. 

On  the  reports  design  screen,  fields  with  the  Horizontal  stretch  function 
will  have  templates  that  consist  of  HHHHH.  The  size  of  these  templates  is 
fixed  and  cannot  be  edited. 

Fields  with  the  Vertical  stretch  function  will  be  represented  by  VVWV 
templates.  You  may  change  the  length  of  these  templates  by  choosing  the 
Template  option  from  the  field’s  definition  menu.  You  can  also  change  the 
size  of  Vertical  stretch  templat^with  Shift  F^.  The  length  of  the  template 
determines  the  width  that  the  field  will  print. 

On  the  labels  design  screen,  the  Vertical  stretch  and  Horizontal  stretch 
options  are  dimmed  and  unavailable. 

Suppress  Repeated  Values 

Choose  this  option  from  the  field  definition  menus  for  any  field  from  which 
you  only  want  to  print  the  first  occurrence  of  each  value. 

For  example,  on  an  expense  account,  you  could  apply  this  attribute  to  the 
Lastname  field,  so  you  don’t  print  the  name  Smith  next  to  each  item  in  Mr. 
Smith’s  report.  Only  the  first  occurrence  of  the  name  would  be  printed  on 
each  page. 

This  option  is  not  available  for  forms  or  labels. 

Remove  Field 

Use  this  option  to  remove  a  field  from  the  work  surface.  If  the  cursor  high¬ 
lights  a  field,  only  that  field  is  removed.  If  the  cursor  is  not  highlighting  a 
field,  then  you  can  pick  the  name  of  a  field  from  a  list  of  fields  on  the  work 
surface. 

To  remove  just  the  current  field,  press  Del. 


Modify  Field 

Use  this  option  to  change  the  options  in  the  field  definition  menu  for  a  field. 

To  change  the  template  of  the  current  field,  you  can  also  press  Ctr^Home  and 
edit  the  field  definition  menu  for  the  current  field. 
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Change  Hidden  Reid 

Hidden  fields  are  special  fields  put  on  the  work  surface  for  making  calcula¬ 
tions  when  a  report  is  printed.  Only  calculated  and  summary  fields  can  be 
hidden.  This  option  is  not  available  for  forms  or  labels,  which  cannot  have 
hidden  fields. 

This  option  lets  you  modify  the  hidden  fields  (you  can’t  place  the  cursor  on 
them  directly  since  they  are  hidden).  A  list  of  the  hidden  fields  will  be  dis¬ 
played,  and  you  can  choose  the  field  you  want  to  change. 

To  change  whether  a  field  is  hidden  or  not,  change  its  Hidden  attribute  on 
the  field  definition  menu. 

The  Bands  Menu 

Use  the  Bands  menu  to  add  or 
remove  group  bands  from  the 
reports  design  screen.  You  can  also 
use  this  menu  to  assign  special 
characteristics  to  individual  bands. 


Add  a  Group  Band 

Choose  this  option  to  insert  a  group  band  inside  the  current  band.  The  cur¬ 
sor  must  be  above  the  report’s  detail  band.  In  other  words,  the  cursor  must 
be  in  the  page  header  band,  the  report  intro  band,  or  an  existing  group  intro 
band. 

You  may  define  groups  in  one  of  three  ways.  You  can  use  the  value  of  a  field, 
such  as  Lastname.  You  can  use  the  value  of  an  expression,  such  as 
CMONTH(due_  date).  You  can  also  use  a  record  count,  such  as  every  12 
records. 

When  you  choose  the  Add  a  group  band  option,  a  submenu  appears  that  lets 
you  specify  how  you  want  to  form  the  group.  After  you  choose  one  of  the 
options  described  below,  a  new  group  is  created.  The  cursor  appears  on  the 
border  line  for  the  new  group. 

Field  Value 

dBASE  IV  displays  a  list  of  the  fields  from  your  database  file  or  view,  along 
with  any  calculated  fields  defined  for  this  report.  When  you  choose  a  field 
from  the  list,  it  is  used  as  the  grouping  value. 
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Expression  Value 

With  this  option,  you  can  enter  a  dBASE  expression  to  define  this  group.  Use 
Shift-FI  Pick  to  choose  field  names,  operators,  or  functions  from  a  displayed 
list  if  you  wish.  You  can  also  type  in  the  expression  directly. 

Record  Count 

Enter  the  number  of  records  you  want  to  include  in  each  group. 

You  can  combine  this  group  value  with  other  values.  For  example,  if  you 
have  a  group  band  defined  on  City,  you  could  also  present  these  records  in 
groups  of  five  by  putting  a  subgroup  with  a  record  count  of  five  inside  the 
group  based  on  City. 

The  record  count  refers  to  records  only,  not  to  the  subgroups  within  a 
group.  For  example,  if  you  put  a  subgroup  based  on  City  inside  a  group 
based  on  a  record  count  of  12,  you  see  12  records  at  a  time,  with  every 
group  of  12  records  organized  into  City  subgroups. 

Remove  Group 

This  option  lets  you  remove  the  current  group  from  the  report.  After  you 
confirm  you  want  to  remove  the  group,  dBASE  IV  deletes  both  the  group 
intro  band  and  the  group  summary  band  of  the  current  group. 

Groups  nested  inside  the  current  group  are  not  removed.  If  you  remove 
Group  2,  for  example,  Groups  3  and  4  will  be  renumbered  to  become 
Groups  2  and  3. 

For  a  shortcut  method  of  deleting  groups,  move  the  highlight  to  the  group’s 
border  line  and  press  Del. 

Modify  Group 

You  can  use  this  option  to  change  the  value  used  to  make  up  the  current 
group.  When  you  select  this  option,  the  submenu  of  types  of  groups  is  dis¬ 
played.  You  can  change  the  type  of  group  or  the  value  used  to  define  the 
group. 

Group  Intro  on  Each  Page 

Sometimes  groups  begin  on  one  page  and  end  on  another.  You  can  use  this 
option  to  specify  that  if  the  current  group  runs  over  to  another  page,  its 
group  introduction  repeats  at  the  top  of  the  new  page. 

This  feature  is  especially  helpful  when  the  group  introduction  contains  col¬ 
umn  headings  for  your  data. 

Open  All  Bands 

When  you  have  some  bands  closed,  you  can  use  this  option  to  quickly  open 
all  bands  to  see  what  is  inside  them.  It  is  also  useful  when  you  want  to  be 
sure  to  print  all  the  bands. 
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Begin  Band  on  New  Page 

You  may  want  certain  groups  to  start  on  fresh  pages.  This  option  tells 
dBASE  IV  to  start  each  new  grouping  for  the  current  group  band  on  a  new 
page.  Each  time  the  current  grouping  value  changes,  the  next  set  of  records 
is  placed  on  a  new  page. 

Word  Wrap  Band 

The  reports  design  work  surface  uses  two  types  of  editing  modes,  layout  and 
word  wrap.  Most  bands  start  out  as  layout  bands,  which  means  they  use  the 
layout  mode. 

You  can  use  this  option  to  change  from  the  layout  mode  to  the  word  wrap 
mode  by  setting  this  option  to  YES.  To  change  from  word  wrap  to  layout, 
switch  this  setting  to  NO. 

When  you  change  a  band’s  editing  mode  from  word  wrap  to  layout,  the  text 
appears  the  same,  but  it  no  longer  wraps.  When  you  change  a  band’s  editing 
mode  from  layout  to  word  wrap,  spaces  are  inserted  to  preserve  the  appear¬ 
ance  of  the  text.  Hard  carriage  returns  are  placed  at  the  end  of  every  line, 
and  each  line,  in  effect,  becomes  a  paragraph. 


WARNING 

If  you  are  going  to  turn  a  word  wrap  band  into  a  layout  band,  try  to 
finish  all  your  work  with  text  in  the  word  wrap  band  before  making 
the  change.  Once  a  word  wrap  band  is  changed  to  a  layout  band,  its 
text  will  no  longer  wrap. 


When  you  choose  MailMerge  layout  from  the  Quick  layout  menu,  the  detail 
band  is  automatically  set  up  as  a  word  wrap  band. 

You  can  read  more  about  the  layout  and  word  wrap  modes  in  Chapter  4, 
“Editing.” 

Text  Pitch  for  Band 

This  option  works  together  with  the  option  of  a  similar  name  in  the  Print 
menu’s  Control  of  printer  submenu.  (For  more  information,  see  Chapter  5, 
“Printing.”) 

The  Print  menu  supplies  the  overall  settings  for  a  report,  but  you  can  specify 
the  text  pitch  for  the  current  band  with  the  Bands  menu.  Settings  assigned 
with  the  Bands  menu  have  priority  when  the  report  is  printed. 

If  you  want  the  current  band  to  use  whatever  setting  the  Print  menu  has  at 
the  time  the  report  is  printed,  choose  the  Default  option. 
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NOTE 

If  you  specify  different  text  pitches,  the  printed  report  will  not  line  up 
as  displayed  on  the  reports  design  screen.  All  characters  on  the  screen 
are  shown  with  the  same  width,  no  matter  what  width  the  characters 
have  when  they  are  printed. 


Quality  Print  for  Band 

This  option  works  together  with  the  option  of  a  similar  name  in  the  Print 
menu’s  Control  of  printer  submenu.  (For  more  information,  see  Chapter  5, 
“Printing.”) 

The  Print  menu  supplies  the  overall  settings  for  a  report,  but  you  can  specify 
the  print  quality  for  the  current  band  with  this  option  on  the  Bands  menu. 
Settings  assigned  with  the  Bands  menu  have  priority  when  the  report  is 
printed. 

If  you  want  the  current  band  to  use  whatever  setting  the  Print  menu  has 
when  the  report  is  printed,  choose  the  Default  option. 

Spacing  of  Lines  for  Band 

This  option  works  together  with  the  Spacing  of  lines  option  in  the  Print 
menu’s  Page  dimensions  submenu.  (For  more  information,  see  Chapter  5, 
“Printing.”) 

The  Print  menu  supplies  the  overall  settings  for  a  report,  but  you  can  specify 
the  line  spacing  for  the  current  band  with  this  option  on  the  Bands  menu. 
Settings  assigned  with  the  Bands  menu  have  priority  when  the  report  is 
printed. 

If  you  want  the  current  band  to  use  whatever  setting  the  Print  menu  has 
when  the  report  is  printed,  choose  the  Default  option. 

Page  Headings  in  Report  Intro 

Normally,  dBASE  IV  will  print  the  information  in  the  page  header  and  page 
footer  bands  when  it  prints  the  report  intro  band. 

You  can  turn  off  this  feature  by  setting  this  option  to  NO.  This  is  useful  when 
you  want  the  data  from  the  report  to  be  introduced  or  summarized  with  a 
cover  letter. 


Other  Menus 

The  remaining  menus  on  the  reports  design  screen  are  described  in  other 
sections  of  this  manual.  The  Words  menu  is  described  in  Chapter  4, 
“Editing.”  The  Go  To  menu  is  explained  in  Chapter  3,  “Browse  and  Edit.” 
The  Print  menu  is  presented  in  Chapter  5,  “Printing.” 

The  Exit  menu  lets  you  choose  Save  changes  and  exit  or  Abandon  changes 
and  exit.  If  you  have  not  given  a  name  to  a  newly  designed  report,  you  will 
be  asked  for  one. 
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Designing 

Labels 


Introduction 

One  of  the  most  useful  capabilities  of  dBASE  IV  is  its  ability  to  help  you 
print  mailing  labels.  Whether  for  monthly  invoices  or  mass  merchandising, 
mailing  labels  get  your  documents  to  the  right  people.  You  can  even  use 
dBASE  IV  to  create  other  types  of  labels,  such  as  name  badges,  hospital  med¬ 
ication  stickers,  or  shipping  tags. 

When  you  design  labels  with  dBASE  IV,  the  layout  editing  mode  makes  it 
easy  for  you  to  describe  what  information  you  want  and  where  you  want  it  to 
appear. 


Labels  can  be  up  to  255  lines  tall  and  255  characters  wide.  You  can  control 
the  height  and  width  of  labels,  as  well  as  how  they  are  printed  on  the  page. 
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The  Labels  Design  Work  Surface 

The  work  surface  for  designing  labels  uses  the  layout  editing  mode,  and  is 
similar  to  the  forms  design  work  surface  or  the  layout  bands  in  reports.  The 
labels  design  work  surface  is  never  larger  than  the  number  of  rows  and  col¬ 
umns  in  the  label. 

When  you  print  several  labels  in  a  row,  the  design  on  the  work  surface  is 
duplicated  for  each  label  in  the  row.  Like  forms  and  reports,  you  can  apply  a 
label  design  to  any  database  file  or  view  that  contains  the  appropriate  fields. 


Trim 


When  you  place  a  field  on  the  labels  work  surface,  dBASE  IV  automatically 
assigns  it  the  trim  picture  function.  The  trim  function  lets  a  field  expand  or 
contract  as  required  by  the  data  in  the  field. 

For  example,  Figure  10-2  shows  how  you  can  print  data  from  a  database 
file’s  City,  State,  and  Zip  fields.  Use  the  Fields  menu  and  its  Add  field  option 
to  place  the  City  field  on  the  work  surface.  Then  move  the  cursor  just  to  the 
right  of  the  City  field’s  template  and  type  a  comma.  Since  the  City  field  has 
the  Trim  function,  the  comma  will  always  appear  just  after  the  name  of  the 
city,  no  matter  how  long  or  short  that  name  is. 

Similarly,  you  can  reserve  exactly  one  space  between  the  comma  and  the 
state’s  abbreviation  by  pressing  Spacebar  to  place  a  blank  space  on  the  work 
surface.  Then  add  the  State  field. 

Normally,  you  would  then  press  Spacebar  several  more  times  and  add  the 
Zip  field.  But  the  label  design  shown  in  Figure  10-2  uses  no  blank  spaces 
between  the  State  and  Zip  field.  This  is  so  we  can  demonstrate  the  effect  of 
the  Trim  function,  combined  with  blank  spaces. 
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Figure  10-3  shows  the  labels  printed  by  the  design  in  Figure  10-2.  Notice  how 
the  city  and  state  appear  just  fine,  with  the  comma  immediately  after  the 
name  of  the  city.  This  is  the  advantage  of  the  TVim  function  option. 
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Figure  10-3  Printed  labels 


The  design  in  Figure  10-2  did  not,  however,  connect  the  State  and  Zip  fields 
with  blank  spaces.  When  the  labels  are  printed,  the  Zip  field  is  always  in  the 
same  place  on  the  label.  Sometimes  it’s  close  enough  to  the  state,  other 
times  it’s  too  far  away.  This  example  demonstrates  the  importance  of  con¬ 
necting  fields  with  blank  spaces  in  order  to  take  full  advantage  of  the  Trim 
option. 

You  can  read  more  about  placing  fields  in  Chapter  9,  “Designing  Reports.” 
You  can  read  more  about  the  layout  mode  in  Chapter  4,  “Editing.” 


Using  Labels  from  dBASE  III  PLUS 


You  can  use  labels  developed  with  dBASE  III  PLUS  directly  in  dBASE  IV.  If 
you  need  to  change  the  layout  of  these  labels,  you  can  import  them  by 
choosing  Add  file  to  catalog  from  the  Control  Center’s  Catalog  menu.  Then 
place  the  labels  on  the  labels  design  screen. 

This  conversion  is  handled  by  changing  fields  that  used  to  be  separated  by 
commas  into  individual  calculated  fields.  Like  other  fields  on  the  labels 
design  work  surface,  these  fields  are  given  the  Trim  and-picture  function  so 
they  will  print  without  unnecessary  blank  spaces. 

Floating  fields,  memo  fields,  and  logical  fields  will  not  be  part  of  the  con¬ 
verted  label,  since  they  were  not  allowed  in  dBASE  III  PLUS  labels.  You  can, 
of  course,  add  these  to  the  new  labels  once  they  have  been  converted  to 
dBASE  IV  labels. 
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Using  the  Labels  Menu  Bar 

The  labels  menu  bar  consists  of  seven  menus:  Layout,  Dimensions,  Fields, 
Words,  Go  To,  Print,  and  Exit. 

The  Words  menu  is  described  in  Chapter  4,  “Editing.”  The  Go  To  menu  is 
explained  in  Chapter  3,  “Browse  and  Edit,“  and  the  Print  menu  is  presented 
in  Chapter  5,  “Printing.” 

The  Layout  Menu 


The  Layout  menu  provides  several 
options  to  help  you  design  or  mod¬ 
ify  labels. 


Use  Different  Database  File  or  View 

A  label  designed  from  the  Control  Center  is  usually  associated  with  a  specific 
database  file  or  view.  The  Use  different  database  file  or  view  menu  option 
lets  you  choose  a  different  source  of  data  to  use  with  the  current  label. 

Unless  you  save  the  label,  this  is  only  a  temporary  change.  The  next  time  you 
use  the  label,  it  will  still  point  to  the  original  database  file  or  view. 

This  is  useful  when  you  have  database  files  or  views  with  the  same  structure, 
and  you  don’t  want  to  store  separate  copies  of  a  label  for  each  data  file. 

When  you  want  to  print  labels  for  the  data  in  a  database  file  or  view,  use  this 
option  to  substitute  that  database  file  or  view  for  the  one  normally  associated 
with  the  current  label. 

If  you  try  to  use  a  database  file  or  view  with  fields  that  do  not  match  those 
already  on  the  labels  design  work  surface,  an  error  message  appears,  This 
message  lists  the  names  of  the  fields  not  found  in  the  database  file  you 
selected. 

If  you  get  this  error  message,  you  may  want  to  choose  a  different  database 
file  or  view  that  has  all  the  firlds  needed  by  the  label  design.  You  could  also 
remove  all  the  field  templates  from  the  design  screen  that  do  not  exist  in  the 
database  file  or  view  you  have  just  chosen. 

Edit  Description  of  Label  Design 

Use  this  option  to  change  the  description  in  the  catalog  of  the  current  label. 
Simply  change  the  existing  description  when  it  is  displayed  on  the  screen. 

Save  This  Label  Design 

This  option  lets  you  save  the  current  label  under  its  present  name  or  under  a 
new  name.  If  you  save  it  under  a  new  name,  the  label  you  are  working  on 
will  use  the  new  name. 
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The  Dimensions  Menu 


The  Dimensions  menu  specifies 
the  shape  and  spacing  of  the  label 
and  its  contents. 


Predefined  Size 

With  the  Predefined  size  option,  you  can  automatically  adjust  your  work 
surface  to  handle  the  most  popular  label  sizes.  When  you  choose  this  option, 
a  submenu  of  common  label  sizes  displays.  Once  you  choose  one  of  these 
sizes,  dBASE  IV  sets  up  the  proper  work  surface. 

The  first  two  dimensions  are  height  and  width.  On  the  Predefined  size  sub¬ 
menu,  these  dimensions  are  presented  in  inches.  Some  of  the  choices  in  the 
Predefined  size  option  also  show  a  third  dimension,  columns.  Since  each 
label  in  a  row  produces  a  column  of  labels  when  the  labels  are  printed,  a 
label  design  with  three  columns  prints  three  labels  across  each  row. 

When  you  choose  a  Predefined  size  option,  the  individual  options  for  the 
rest  of  the  Dimensions  menu  are  automatically  filled  in. 


NOTE 

The  Width  of  label  setting  is  filled  in  for  Pica  pitch.  If  you  are  printing 
with  Elite  or  Condensed,  you  can  increase  the  Width  of  label  setting 
as  needed.  The  Height  of  label  option  is  based  on  six  lines  per  inch.  If 
your  printer  differs  from  this,  you  may  need  to  adjust  this  number 
accordingly. 


If  you  change  print  settings  after  choosing  a  label  size,  you  may  need  to 
adjust  the  other  settings  in  the  Dimensions  menu.  These  are  not  automati¬ 
cally  reset  if  you  alter  the  number  of  characters  per  inch. 

The  Print  menu  has  relevant  options  that  may  need  to  be  reset.  For  example, 
the  number  of  characters  per  inch  is  adjusted  with  the  Tfcxt  pitch  option  on 
the  Print  menu’s  Control  of  printer  submenu.  Pica  is  10  characters  to  the 
inch,  and  Elite  is  12  characters  to  the  inch.  The  number  of  characters  per 
inch  for  condensed  print  depends  on  your  printer. 

The  number  of  lines  printed  per  inch  also  depends  on  your  printer,  and  is 
established  when  you  choose  the  print  driver  in  your  Config.db  file.  You  can 
read  more  about  the  Print  menu  in  Chapter  5,  “Printing.” 


Width  of  Label 

This  option  specifies  the  width  of  the  label  in  total  characters.  The  maximum 
setting  is  255  characters. 

If  you  try  to  make  this  number  smaller  than  the  space  needed  for  the  text 
and  field  templates  already  on  the  work  surface,  a  warning  message  appears. 
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Height  of  Label 

This  option  specifies  the  height  of  the  label  in  printed  lines.  If  your  printer 
prints  six  lines  per  inch,  a  15/16-inch  sized  label  can  contain  five  lines.  The 
maximum  setting  is  255  lines. 

Indentation 

This  option  modifies  the  amount  of  space  the  printer  leaves  before  beginning 
to  print.  It  is  added  to  the  beginning  print  position  as  set  by  the  Offset  from 
left  option  on  the  Print  menu’s  Page  dimensions  submenu.  The  range  of 
values  for  this  setting  is  0  to  250. 

Lines  between  Labels 

This  option  specifies  the  number  of  blank  lines  between  the  bottom  of  one 
label  and  the  top  of  the  next.  The  range  of  this  setting  is  0  to  16  lines. 

Spaces  between  Label  Columns 

This  option  specifies  the  number  of  spaces  to  leave  between  the  right  side  of 
one  label  and  the  left  side  of  the  next.  This  setting  can  be  any  number  from  0 
to  120. 

Columns  of  Labels 

This  option  specifies  how  many  labels  to  print  in  each  row.  This  setting  can 
be  from  1  to  15.  You  may  also  be  limited  by  the  maximum  total  width 
allowed  by  the  labels  design  screen  and  your  printer. 


The  first  setting  used  by  dBASE  IV  is  the  Offset  from  left  option  from 
the  Print  menu ’s  Page  dimensions  submenu.  The  Indentation  setting 
is  then  added  to  the  offset  number.  The  Width  of  label  comes  next, 
followed  by  Spaces  between  labels.  You  can  have  more  than  one  col¬ 
umn  of  labels,  but  the  total  width  taken  up  by  your  design  cannot  be 
more  than  255  characters. 


NOTE 

Several  of  these  label  settings  are  additive,  and  their  sum  (not  includ¬ 
ing  Offset  from  left )  cannot  be  more  than  255. 


The  Fields  Menu 

You  use  the  Fields  menu  to  place  fields  from  the  database  file  or  view  onto 
the  work  surface.  You  can  also  place  calculated  fields  created  for  this  label, 
and  predefined  fields  such  as  Date  and  Time. 

On  the  labels  design  screen,  the  Add  field  menu  does  not  contain  the 
Suppress  repeated  values  or  Hidden  options.  The  picture  function  menu 
also  does  not  contain  the  Vertical  stretch  or  Horizontal  stretch  option. 

You  can  read  more  about  the  Fields  menu  and  picture  functions  in  Chapter 
9,  “Designing  Reports.” 
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Other  Menus 

The  remaining  menus  on  the  labels  design  screen  are  described  in  other  sec¬ 
tions  of  this  manual.  The  Words  menu  is  described  in  Chapter  4,  “Editing.” 
The  Go  To  menu  is  explained  in  Chapter  3,  “Browse  and  Edit.”  The  Print 
menu  is  presented  in  Chapter  5,  “Printing.” 

The  Exit  menu  lets  you  choose  Save  changes  and  exit  or  Abandon  changes 
and  exit. 
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Applications 


Introduction 


One  of  the  most  powerful  aspects  of  dBASE  IV  is  its  built-in  programming 
language.  Programs  let  you  perform  several  separate  tasks  with  a  single  DO 
command.  This  can  save  you  hours  of  repetitive  keystroking.  You  can  even 
combine  programs  into  larger  applications. 


Programs  and  Applications 


There  is  no  formal  dividing  line  between  programs  and  applications,  and 
this  manual  sometimes  uses  these  terms  interchangeably.  The  word  applica¬ 
tions,  however,  is  generally  reserved  for  programs  that  provide  greater 
functionality. 

You  could,  for  example,  create  a  program  to  help  you  enter  orders.  If  you 
link  this  program  together  with  other  programs  that  manage  inventory,  ship¬ 
ping,  and  so  on,  you  might  call  the  whole  package  an  application. 

The  panel  on  the  Control  Center  is  called  Applications  because  this  is  where 
you  can  put  the  names  of  your  larger  programs.  These  programs  can  call  any 
smaller  programs  they  need.  You  can  also  put  every  program  you  have  in  the 
Applications  panel,  but  you  may  find  it  harder  to  locate  your  important 
applications  if  there  are  many  names  in  the  panel. 

In  addition  to  dBASE  IV  programs,  you  can  also  place  DOS  programs  in  the 
Applications  panel.  For  example,  you  could  put  .exe  or  .com  programs  in 
the  panel  so  they  can  be  executed  directly  from  the  Control  Center.  You  can 
also  put  batch  files  (.bat)  into  the  Applications  panel. 


Program  Writing  Tools 


dBASE  programs  can  be  written  in  any  word  processor  that  produces  ASCII 
text.  In  addition,  you  can  take  advantage  of  two  powerful  tools  for  writing 
programs  inside  dBASE  IV. 

One  approach  is  to  use  the  program  editor,  which  is  basically  the  word  wrap 
editing  mode  described  in  Chapter  4,  “Editing.”  The  program  editor  offers 
you  maximum  flexibility.  You  can  also  create  programs  with  the  dBASE IV 
Applications  Generator.  This  tool  is  easy  to  use  and  provides  you  with  built-in 
assistance  for  developing  menus  and  interfaces  for  your  applications. 
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Both  the  program  editor  and  the  dBASE  IV  Applications  Generator  take 
advantage  of  the  database  files,  views,  forms,  reports,  and  labels  created  with 
the  full-screen  work  surfaces  described  in  this  manual. 

If  you  use  an  external  text  editor  to  write  programs,  save  the  text  in  the  edi¬ 
tor’s  ASCII  file  format.  This  is  sometimes  called  the  non-document  mode.  If 
you  do  not  use  the  editor’s  ASCII  mode,  any  special  control  characters  used 
by  the  text  editor  will  cause  a  problem  when  you  try  to  run  the  program. 

To  tell  dBASE  IV  you  want  to  use  an  external  editor  for  programs,  use  the 
TEDIT  setting  in  your  Config.db  file. 


NOTE 

Do  not  confuse  the  TEDIT  setting  with  the  WP  setting,  which  assigns 
an  external  editor  for  memo  fields. 


Running  Applications 

Once  an  application  is  written,  you  can  run  it  in  one  of  two  ways: 

■  From  the  dot  prompt,  you  can  type  DO  followed  by  the  name  of  the 
application. 

■  From  the  Control  Center,  you  can  select  the  name  of  an  application  in 
the  Applications  panel  and  press  *-»•.  dBASE  IV  will  ask  you  to  confirm 
that  you  want  to  run  the  program.  If  you  do  this,  the  program  will  start 
working.  You  can  also  choose  to  abandon  the  operation  at  this  point. 

The  Debugger 

Sometimes  new  programs  contain  mistakes.  These  bugs  must  be  found  and 
corrected. 

You  can  use  the  Debugger ,  a  special  work  surface  that  comes  into  play  when 
a  program  error  is  encountered.  You  can  use  the  Debugger  easily  after  modi¬ 
fying  a  program  by  choosing  the  Debug  program  option  from  the  program 
editor’s  Exit  menu. 

You  can  also  turn  on  the  Debugger  by  setting  Trap  ON.  You  can  do  this 
from  the  Control  Center  with  the  Settings  menu  reached  through  the  Tools 
menu.  From  the  dot  prompt,  you  can  turn  on  the  Debugger  by  typing  £et 
trap  on. 

You  can  read  more  about  the  Debugger  in  Language  Reference. 
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Reaching  an  Application  Writing  Screen 

There  are  three  ways  to  reach  the  program  editor  or  the  dBASE  IV  Applica¬ 
tions  Generator. 

■  From  the  dot  prompt,  you  can  use  MODIFY  COMMAND  <  filename  >  to 
reach  the  program  editor,  or  you  can  type  CREATE  APPLICATION 

<  filename  >  or  MODIFY  APPLICATION  <  filename  >  to  reach  the 
dBASE  IV  Applications  Generator.  If  you  do  not  enter  the  name  of  an 
application  with  the  command,  dBASE  IV  will  ask  you  for  one. 

■  From  the  Control  Center,  you  can  select  the  <  create >  marker  in  the 
Applications  panel  and  press  *-►.  You  can  then  choose  to  create  a  new 
application  with  either  the  program  editor  or  the  dBASE  IV  Applications 
Generator. 

■  If  you  select  the  name  of  an  existing  application  from  the  Applications 
panel  and  press  Shift-F2  Design,  dBASE  IV  will  take  you  to  the  program 
editor  or  the  dBASE  IV  Applications  Generator,  whichever  program  writ¬ 
ing  tool  was  used  to  make  the  application. 

The  program  editor  is  basically  the  word  wrap  mode  with  a  few  special 

touches.  These  exclusive  programming  features  are  described  in  this  chapter. 

The  word  wrap  mode  is  described  in  Chapter  4,  “Editing.” 

The  dBASE  IV  Applications  Generator  is  described  in  Using  the  dBASE  IV 

Applications  Generator. 


Using  the  Program  Editor  Menu  Bar 

The  program  editor  menu  bar  has  five  menus:  Layout,  Words,  Go  To,  Print, 
and  Exit. 

Several  of  the  menus  on  the  program  editor  screen  are  described  in  other 
sections  of  this  manual.  The  Words  menu  is  described  in  Chapter  4, 
“Editing.”  The  Go  To  menu  is  explained  in  Chapter  3,  “Browse  and  Edit.” 

When  you  write  programs  in  dBASE  IV,  the  text  is  saved  as  an  ASCII  file. 
This  means  you  cannot  store  styling  information  or  preserve  special  tab  set¬ 
tings  in  programs. 

This  chapter  describes  the  Layout,  Print,  and  Exit  menus. 

The  Layout  Menu 


The  Layout  menu  lets  you  bring 
different  programs  into  the 
program  editor.  You  can  also 
change  the  description  of  the  cur¬ 
rent  program,  which  is  kept  in  the 
current  catalog. 
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Modify  a  Different  Program 

Choose  this  option  to  edit  a  different  program. 

If  you  made  any  changes  to  the  current  program,  dBASE  IV  first  gives  you 
the  opportunity  to  save  those  changes.  Then  enter  the  name  of  the  .prg  file 
you  want  to  modify.  You  can  also  press  Shift-FI  Pick  to  see  a  list  of  the  avail¬ 
able  .prg  files. 

You  can  also  enter  the  full  name  of  other  ASCII  files  if  you  want  to  edit  them 
from  this  screen. 


Dot  prompt  equivalent  command 
MODIFY  COWAND 


Edit  Description  of  Program 

This  option  lets  you  modify  the  catalog  description  of  the  current  program 
file.  If  no  catalog  is  opefyythis  option  is  dimmed. 

Save  this  Program 

You  can  use  this  option  to  copy  the  current  program  by  saving  it  under  a  dif¬ 
ferent  name.  You  can  also  use  this  option  to  save  program  coding  changes  as 
you  go  along,  preventing  data  loss  in  the  event  of  a  power  drop  or  other 
electronic  problem. 


The  Print  Menu 

The  Print  menu  for  programs  is  almost  identical  to  the  basic  Print  menu 
described  in  Chapter  5,  “Printing.”  There  is,  however,  one  special  option  for 
the  program  editor. 

The  Line  numbers  option  prints  the  line  number  at  the  left  of  every  line. 
These  line  numbers  help  you  keep  track  of  where  you  are,  especially  in  large 
programs. 


The  Exit  Menu 


With  the  Exit  menu,  you  can  leave 
the  program  editor. 
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Save  Changes  and  Exit 

You  can  use  this  option  to  save  a  new  or  modified  program. 

If  you  came  to  the  program  editor  from  the  Control  Center,  you  will  return 
to  the  Control  Center.  If  you  came  from  the  dot  prompt  or  a  program,  you 
will  return  to  the  dot  prompt  or  program. 

Abandon  Changes  and  Exit 

After  you  select  this  option,  you  will  be  asked  to  verify  that  you  really  do 
want  to  abandon  your  changes.  If  you  confirm  this  intention,  any  unsaved 
changes  to  the  current  program  are  abandoned. 

If  you  came  to  the  program  editor  from  the  Control  Center,  you  will  return 
to  the  Control  Center.  If  you  came  from  the  dot  prompt  or  a  program,  you 
will  return  to  the  dot  prompt  or  program. 


Run  Program 

This  option  lets  you  run  the  program  with  which  you  are  working.  It  is  a 
shortcut  that  saves  any  changes  to  the  program,  then  immediately  runs  the 
current  program . 

When  the  program  finishes,  you  will  return  to  either  the  Control  Center  or 
the  dot  prompt,  depending  on  where  you  came  from. 


Debug  Program 

This  option  saves  the  current  program,  makes  sure  the  Debugger  is  turned 
on,  and  then  displays  the  Debugger  screen.  This  lets  you  set  up  the  Debugger 
before  the  program  starts  executing. 

This  is  particularly  helpful  if  you  want  to  have  the  program  stop  at  certain 
break  points.  The  Debugger  is  described  in  Language  Reference. 

When  you  select  this  option,  you  have  the  opportunity  to  enter  a  list  of 
parameters  that  will  be  passed  to  the  program.  When  the  program  finishes, 
you  will  return  to  either  the  Control  Center  or  the  dot  prompt,  depending  on 
where  you  came  from. 


Dot  prompt  equivalent  command 
DEBUG 
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Catalogs 


Introduction  to  Catalogs 


As  you  work  with  dBASE  IV,  you  will  probably  find  yourself  creating  numer¬ 
ous  database  files,  reports,  forms,  and  other  types  of  files.  dBASE  IV’s  cata¬ 
logs  help  you  organize  your  work. 


A  catalog  is  a  list  of  files  in  dBASE  IV.  You  decide  which  files  to  put  into 
each  catalog,  and  modify  your  catalogs  whenever  you  want. 

Catalogs  contain  the  names  and  locations  of  files,  with  short  descriptions  of 
the  files.  These  descriptions  are  displayed  as  you  work  with  files,  to  help  you 
remember  what  is  in  them. 


How  Catalogs  Differ  from  Directories 

Catalogs  and  directories  are  both  used  to  organize  files,  but  in  different  ways. 

Directories  contain  the  files  on  your  disk,  like  drawers  in  a  filing  cabinet. 
Each  file  is  in  a  particular  directory,  and  if  you  delete  a  file  from  a  directory, 
it  is  permanently  erased  from  the  disk. 

Catalogs,  on  the  other  hand,  are  simple  lists  of  filenames,  like  grocery  lists. 
They  do  not  contain  the  files,  and  removing  a  filename  from  one  catalog 
removes  it  only  from  that  particular  list  of  names.  The  file  remains  on  the 
disk. 
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DIRECTORIES 


EMPLOYEE  .DBF 

-CODES  .DBF 

CONTENTS  DBF 

NAMES  .DBF 

PEOPLE  .DBF 

GUESTS  .QBE 

-  ADDCODES  UPD 


ALLNAMES  .LBL 
AREACODE  .PRG" 
-CONTACTS  .SCR 
INVITES  .LBL  - 
-CARDREC  ,FRM 
REGIONAL  .FRM 
SALESRPT  FRM 


CODES 

CONTENTS 

EMPLOYEE 

NAMES 

PEOPLE 

ADDCODES 

GUESTS 

CONTACTS 

ITEMS 

NEW  DATA 

1  CARDREC 
:  REGIONAL 
i  SALESRPT 

ALLNAMES  I 
INVITES - 1 

AREACODE 

BUSINESS 

PERSONAL 

Data 

Queries 

Forms 

Reports 

Labels 

Applications 

CATALOG 


Rgure  12-1  Catalogs  and  directories 


You  can  list  the  same  file  in  several  different  catalogs  at  the  same  time.  Each 
catalog  contains  its  own  description  of  the  files  listed  in  it.  This  is  useful 
when  the  same  file  is  used  for  different  purposes  in  different  catalogs. 


Listing  the  Same  File  in  More  than  One  Catalog 

As  you  develop  catalogs,  you  will  need  to  strike  the  right  balance  between 
listing  the  same  file  in  several  catalogs  or  creating  separate  copies  of  a  file 
for  each  catalog.  These  decisions  depend  on  your  particular  situation.  The 
following  guidelines  may  be  helpful: 

■  Try  to  share  database  files  between  catalogs,  rather  than  making  individ¬ 
ual  copies  for  each  catalog. 

Database  files  are  usually  large,  and  it’s  better  to  store  your  data  in  only 
one  place.  For  example,  if  you  have  employee  information  stored  in  sev¬ 
eral  different  database  files,  you  must  edit  all  the  copies  whenever  the 
information  changes. 

■  Consider  making  distinct  views  for  each  catalog. 

Views  take  up  little  disk  space,  and  work  best  when  tailored  to  the  needs 
of  an  individual  catalog.  By  not  sharing  your  views  with  other  catalogs, 
you  can  modify  them  without  worrying  how  your  changes  might  affect 
other  catalogs. 

This  is  important,  since  every  catalog  can  contain  numerous  forms, 
reports,  and  labels,  which  will  be  dependent  on  the  views  in  the  catalog. 
If  you  change  a  view  that  is  used  by  other  catalogs,  this  could  throw  off 
the  forms,  reports,  and  labels  in  those  other  catalogs. 
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■  Use  similar  field  names  in  database  files  or  views. 


If  every  form,  report,  or  label  can  expect  to  find  the  same  field  names  in 
different  database  files,  then  you  can  use  these  forms,  reports,  or  labels 
for  many  different  database  files.  This  helps  save  disk  space  and  the  time 
it  would  otherwise  take  you  to  design  different  forms,  reports,  and  labels. 

For  example,  you  could  design  a  standard  label  format  to  apply  to  all 
your  database  files  that  contain  for  employees  or  clients  records. 


Typical  Uses  of  Catalogs 


Catalogs  are  used  to  group  together  all  the  files  needed  for  one  type  of  job. 
You  could  have  different  catalogs  for  each  office,  department,  or  product 
line.  Or  you  might  have  catalogs  that  group  together  the  files  needed  for  pre¬ 
paring  your  company’s  annual  report  or  newsletter. 

You  can  have  as  many  catalogs  as  you  want.  One  of  the  basic  purposes  of  cat¬ 
alogs  is  to  simplify  the  lists  of  files  displayed  in  the  Control  Center  or  other 
file  lists.  Use  them  to  temporarily  eliminate  extraneous  files  from  your  work¬ 
ing  environment,  so  you  can  concentrate  on  only  those  files  currently 
needed. 


Choosing  the  Initial  Catalog 


When  you  enter  the  Control  Center,  dBASE  IV  automatically  loads  the  last 
catalog  you  were  using  when  you  left  the  Control  Center.  If  you  have  not 
created  any  catalogs  yet,  dBASE  IV  creates  a  catalog  for  you.  This  initial  cat¬ 
alog,  named  Untitled,  contains  all  the  relevant  dBASE  IV  files  in  the  current 
directory. 

To  specify  another  catalog  to  be  the  initial  catalog  when  you  enter  the  Con¬ 
trol  Center,  you  specify  that  catalog  in  your  Config.db  file.  See  the  SET 
CATALOG  TO,  SET  CATALOG  ON/OFF,  and  Config.db  entries  in  Language 
Reference. 


The  Catalog  Menu 


The  Catalog  menu  appears  on  the 
Control  Center  menu  bar.  This 
menu  lets  you  add  or  remove 
files  from  a  catalog.  You  can  also 
change  the  description  of  files 
in  the  catalog  or  load  a  different 
catalog. 
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Use  a  Different  Catalog 

If  you  choose  this  option,  a  list  of  other  catalogs  displays.  A  description  of 
each  catalog  appears  as  you  move  the  highlight  up  and  down  the  list.  Select 
the  name  of  an  existing  catalog  or  choose  the  <  create  >  marker  to  create  a 
new  catalog. 


Modify  Catalog  Name 

Use  this  option  to  modify  the  name  of  the  current  catalog  by  editing  the 
name  as  it  appears  on  the  screen. 

Edit  Description  of  Catalog 

Use  this  option  to  modify  the  description  of  the  current  catalog  by  editing 
the  description  as  it  appears  on  the  screen. 

Add  File  to  Catalog 

Use  this  option  to  add  files  to  the  current  catalog.  Each  panel  can  contain  up 
to  200  files. 

Only  those  files  that  belong  in  the  panel  containing  the  cursor  will  be  dis¬ 
played  on  the  screen.  For  example,  if  the  cursor  is  in  the  Forms  panel  when 
you  choose  the  Catalog  menu,  your  choice  of  files  to  add  to  the  catalog  will 
be  limited  to  form  files. 

Each  query,  form,  report,  label,  and  program  can  be  described  by  up  to 
three  files.  These  files  are  related  to  each  other,  much  like  an  architect’s 
blueprint,  scale  model,  and  finished  building. 

The  initial  files  are  called  design  files  and  are  created  on  design  screens. 
These  files  are  like  the  architect’s  blueprints.  An  .scr  file,  for  example,  is  the 
design  file  for  forms. 

When  design  files  are  saved,  they  automatically  create  generated  code  files, 
which  consist  of  dBASE  code.  Generated  code  files  are  like  an  architect’s 
scale  model.  They’re  closer  to  the  real  thing,  but  still  not  workable.  These 
files  are  useful  if  you  want  to  customize  the  code  in  special  ways.  The  .fmt 
files  are  the  generated  code  files  for  forms. 

The  final  step  in  this  process  comes  when  you  ask  to  use  a  query,  form, 
report,  label,  or  program.  At  that  time,  the  generated  code  files  are  stream¬ 
lined  into  compiled  files.  Compiled  files  replace  dBASE  code  with  a 
command  shorthand  that  lets  them  run  faster. 

Compiled  files  are  like  an  architect’s  finished  building.  When  you  use  a 
query,  form,  report,  label,  or  program,  you’re  working  with  compiled  files. 
The  .fmo  files  are  the  compiled  files  for  forms. 

Table  2-1  shows  the  type  of  files  and  their  extensions. 
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Table  2-1  File  extensions 


Type  of  file 

Panel 

Design 

Code 

Compiled 

Database 

Data 

.dbf 

View  query 

Queries 

.qbe 

.qbo 

Update  query 

Queries 

.upd 

.upo 

dBASE  III  view 

Queries 

.vue 

Form 

Forms 

.scr 

.fmt 

.fmo 

Report 

Reports 

.frm 

•frg 

.fro 

Label 

Labels 

.Ibl 

•lbg 

.lbo 

Program 

Applications 

prg 

.dbo 

dBAS  E/SQL 
program 

Applications 

.prs 

.dbo 

ApGen  file 

Applications 

.app 

•Prg 

.dbo 

The  file  extensions  in  the  third  column  of  Table  2-2  show  the  types  of  files 
you  may  add  to  the  Control  Center  with  the  Add  file  to  catalog  option  of  the 
Catalog  menu.  For  forms,  reports,  and  labels,  you  can  add  design  and  com¬ 
piled  files,  but  not  generated  code  files. 

If  you  have  both  a  design  file  and  a  compiled  file  for  a  report,  form,  or  label, 
you  only  need  to  add  the  design  file  to  the  catalog,  since  dBASE  IV  will  cre¬ 
ate  the  compiled  file  automatically.  Compiled  files  are  available  in  the  lists 
for  queries,  forms,  labels,  reports,  and  programs  if  you  are  not  the  file’s 
designer  and  do  not  have  access  to  the  design  or  generated  code  files. 
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Table  2-2  Catalog  file  extensions 


Type  of  file 

Panel 

In  list 

In  Untitled.cat 

Database 

Data 

.dbf 

.dbf 

dBASE  III  PLUS  index 

Data 

.ndx 

View  query 

Queries 

.qbe,  .qbo 

.qbe 

Update  query 

Queries 

.upd,  .upo 

.upd 

dBASE  III  PLUS  view 

Queries 

.vue 

.vue 

Form 

Forms 

.scr,  .fmo 

.scr,  .fmt 

Report 

Reports 

.frm,  .fro 

.frm,  .frg 

Label 

Labels 

.Ibl,  .lbo 

.Ibl,  .lbg 

Program 

Applications 

.prg,  .dbo 

dBASE/SQL  program 

Applications 

.prs,  .dbo 

ApGen  file 

Applications 

.app 

.app 

External  programs 

Applications 

.exe,  .com 

When  dBASE  IV  is  loaded  from  a  directory  that  contains  no  catalogs,  it  auto¬ 
matically  creates  a  special  catalog  named  Untitled. cat.  For  this  catalog,  only 
certain  files  are  included.  The  extensions  of  these  files  are  shown  in  the 
Untitled.cat  column  of  Table  2-2. 

Generated  code  files  cannot  be  loaded  onto  the  design  screens,  but  they  can 
be  used  to  carry  out  functions  such  as  formatting  data  entry  screens  or  print¬ 
ing  reports  and  labels. 

Since  compiled  files  can  always  be  created  from  design  files  or  from  gener¬ 
ated  code  files,  dBASE  IV  does  not  bother  to  automatically  load  compiled 
files  into  Untitled.cat. 

In  addition,  because  there  may  be  many  programs  in  a  directory,  only  those 
large  programs  with  an  .app  extension  are  automatically  loaded  into/Untit- 
led.cat. 


Remove  Highlighted  File  from  Catalog 

Use  this  option  to  remove  the  current  file  from  the  catalog.  dBASE  IV  also 
asks  if  you  want  to  delete  the  current  file  from  your  disk.  The  current  data¬ 
base  file  must  be  closed  before  you  can  delete  it  from  the  disk. 

Remember  that  some  other  catalog  may  list  a  file  in  the  current  catalog,  so 
be  cautious  when  deleting  a  file  from  the  disk.  Removing  a  file  from  your 
catalog  is  only  temporary,  and  you  can  easily  put  the  file  back  into  the  cata¬ 
log  later.  Deleting  a  file  from  the  disk  is  a  permanent  action  that  you  cannot 
undo. 
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Change  Description  of  Highlighted  File 

Use  this  option  to  change  the  description  of  the  current  file  by  editing  the 
description  in  a  prompt  box.  Note  that  the  new  description  then  appears  to 
the  right  of  the  word  Description  near  the  bottom  of  the  screen. 
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Tools 


Tk<s  Tools  Menu 


The.  Took 

A 


The  Tools  menu  provides  utilities  that  can  increase  your  productivity.  You 
can  use  the  options  on  this  menu  to  manage  files,  reach  DOS  from  within 
dBASE  IV,  customize  dBASE  IV,  restrict  access  to  confidential  files,  and  set 
up  keyboard  macros. 


Reaching  the  Tools  Menu 


From  the  Control  Center,  you  can  reach  the  Tools  menu  by  pressing 
F10  Menus  and  then  selecting  Tools  from  the  menu  bar.  You  can  also  press 
Alt-T  to  select  the  Tools  menu  directly. 

To  use  the  Tools  menu  from  the  dot  prompt,  you  must  first  go  to  the  Control 
Center  by  typing  assist.  You  can  then  select  Tools  from  the  menu  bar. 

One  of  the  options  on  the  Tools  menu  is  Macros.  You  can  reach  an  abbrevi¬ 


ated  version  of  the  Macros  submenu  from  anywhere  in  dBASE  IV.  To  do 


this,  press  Shift-FlO  Macros.  You  can  then  use  this  submenu  to  play  and 
record  macros. 


The  Tools  Menu  Options 


Some  of  the  options  on  the  Tools  menu  bring  up  submenus,  while  others 
present  new  menu  bars.  DOS  utilities,  Protect  data,  and  Settings  are  the 
options  that  display  new  menu  bars.  When  you  leave  these  menu  bars,  you 
return  directly  to  the  Control  Center,  rather  than  to  the  Tools  menu. 
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ISE  IV  CONTROL  CENTER 
C  >  \DB  ft  SEN  SAMP  LESS  SAMPLES.  CRT 


create > 

<  create  > 

<  create > 

< create  > 

ADDBOOK 

CONTACTS 

OBJECTS 

PHONELOG 

ALLNAMES 
CARDS EC 

INU ENTRY 
REGIONAL 

CARDONLV 

INVITES 

MAILALL 

NAMETAGS 

AREACOOE 

BUSINESS 

CHRTNSTR 

DEMOS 

PERSONAL 

Rgure  1 3-1  The  Tools  menu 


Figure  13-1  shows  the  Tools  menu  pulled  down  from  the  Control  Center 
menu  bar. 


The  Macros  Menu 


Keyboard  macros  help  you  capture 
repetitive  keystrokes  and  save  time. 

Whenever  you  find  yourself  doing 
the  same  set  of  keystrokes 
frequently,  you  might  consider 
making  a  macro  to  simplify  your 
work.  The  macro  records  your  key¬ 
strokes  exactly  as  you  enter  them. 

You  can  then  use  the  macro  to  play 
back  your  keystrokes  automatically, 
like  a  player  piano. 

For  example,  you  could  create  a  macro  that  enters  the  name  of  your  com¬ 
pany.  Instead  of  typing  Consolidated  Fish  Meal,  Inc.  over  and  over,  you  could 
simply  play  a  macro  that  types  all  four  words  for  you  with  only  a  few  key¬ 
strokes.  You  could  also  make  a  macro  to  lay  out  standard  elements  of  a  form 
or  label. 

You  can  play  back  a  macro  by  choosing  the  Play  option  from  the  Macros 
menu.  A  faster  way  to  play  macros  is  to  use  the  macro  key  combination, 

Alt-FIO.  After  pressing  the  macro  key  combination,  the  next  letter  you  press 
tells  dBASE  IV  which  macro  to  play. 

For  example,  if  a  Consolidated  Fish  Meal,  Inc.  macro  was  assigned  to  the  let¬ 
ter  c,  you  could  toe  Alt-FIO-c. 

y\ 


13-2 


TOOLS 


PAGE:  3  SESS:  5  Tub  May  17  23:22:29  1988 
sk2/al  I  J  obz/CLS_niBnhat/GRP_jnanhat/J0B_menusemen/DIV_uinch8pl3 

Function  keys  are  an  even  faster  way  to  carry  out  your  favorite  macros.  If 
you  assign  a  macro  to  F3,  you  can  play  back  that  macro  by  entering  Alt-F3. 

Neither  the  macro  key  (Shift-FlO  Macros)  nor  any  keys  pressed  while  the 
Macros  menu  is  on  the  screen  are  recorded  in  macros.  You  can  enter  the 
Shift-FlO  Macros  key  into  a  macro  by  using  the  macro  editor,  available  with 
the  Modify  option. 

Macros  play  back  exactly  as  they  were  recorded.  You  need  to  take  this  into 
account  when  creating  macros.  For  example,  a  macro  that  uses  |  to  reach  a 
particular  file  in  a  files  list  will  not  work  if  the  number  of  files  at  the  top  of 
the  list  changes.  When  that  happens,  the  cursor  will  go  either  too  far  or  not 
far  enough. 

There  are  two  ways  to  make  macros  as  accurate  as  possible: 

■  Choose  menus  and  menu  options  by  their  first  letter. 

For  example,  on  any  screen  that  has  the  Words  menu,  the  keystrokes 
Alt-wpcwill  reach  the  Position  option  on  the  Words  menu  and  center 
the  selected  text. 

■  Spell  out  all  file  or  field  names  to  be  chosen  from  lists  of  choices  on  the 
screen. 

For  example,  if  you  are  at  the  Control  Center  and  execute  a  macro  that 
enters  Alt-CUsamples.cat«-»>,  you  will  always  switch  to  the  Samples  cata¬ 
log  if  it’s  on  the  list  of  catalogs. 

You  may  develop  a  set  of  macros  useful  in  one  situation,  but  not  in  another. 
You  can  store  collections  of  macros  in  macro  libraries.  Each  library  is  a  sep¬ 
arate  file  that  contains  up  to  34  macros.  You  can  change  your  macros 
quickly  by  loading  and  unloading  macro  libraries. 


Language  Reference. 


NOTE 

A  keyboard  macro  is  different  from  the  &  macro  used  at  the  dot 
prompt  and  in  dBASE  programs.  You  can  read  about  the  &  macro  in 
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Begin  Recording 


Choose  this  option  to  record  a  macro.  The  macro  display  table  shown 
ure  13-2  appears. 


*in|Fig- 


Figure  1 3-2  The  macro  display  table 

The  macro  display  table  shows  the  letters  for  your  current  macro  library. 

The  top  part  of  the  list  shows  the  macros  assigned  to  function  keys.  The  bot¬ 
tom  part  of  the  list  shows  the  macros  assigned  to  the  26  letter  keys,  a 
through  z. 

To  record  a  new  macro,  press  the  function  key  or  letter  you  want  to  use  for 
playing  back  the  macro.  If  you  have  chosen  a  key  already  used  by  a  macro, 
you  are  asked  to  confirm  that  you  want  to  overwrite  the  current  macro.  You 
are  then  asked  to  enter  a  name  for  the  macro.  When  you  have  entered  the 
name,  press 

The  macro  display  table  and  the  macros  menu  disappear  from  the  screen, 
and  you  can  begin  recording  the  new  macro.  When  you  have  finished 
recording  the  macro,  press  Shift-FlO  Macros  followed  by  the  letter  e. 

The  macro  you  just  recorded  is  stored  in  the  current  macro  library  and  is 
ready  to  be  played  back.  If  you  forget  what  key  you  assigned  to  which  macro, 
you  can  always  go  to  the  macro  display  table  and  check. 


NOTE 

Alt-FlO  cannot  be  assigned  a  macro,  since  it  is  the  gateway  to  the  let¬ 
ter  macros  listed  in  the  bottom  part  of  the  macro  display  table. 


13-4 


TOOLS 


PAGE:  5  SESS:  5  Tue  flay  17  23:22:29  1988 

?/al I Jobz/CLS_manhat/GRP_manhat/JO0_manusemen/DIV_umchapl3 

When  you  are  on  the  work  surface  or  in  menus  other  than  the  Macros 
menu,  you  can  play  the  macros  in  the  top  part  of  the  table  by  holding  down 
Alt  and  pressing  the  desired  function  key.  Play  the  macros  in  the  bottom  part 
of  the  table  by  pressing  Alt-FlO  followed  by  the  desired  letter. 


End  Recording 

Use  this  option  to  finish  recording  a  macro.  To  easily  reach  the  End  record¬ 
ing  menu  option  while  recording  a  macro,  simply  type  Shift-FlO  Macros  fol¬ 
lowed  by  the  letter  e. 

The  macro  will  be  saved  in  memory.  If  you  want  to  save  this  new  macro  for 
use  in  future  sessions  with  dBASE  IV,  make  sure  you  save  the  current  mac¬ 
ros  with  the  Save  library  option,  described  below. 


Append  to  Macro 

Use  this  option  to  add  material  to  the  end  of  an  existing  macro.  The  macro 
display  table  appears  on  the  screen  and  you  press  the  key  of  the  macro  you 
want  to  modify.  The  macro  display  disappears  and  you  can  begin  appending 
to  what  is  already  in  the  macro. 


■ra  tip 

If  you  want  to  be  on  a  work  surface  other  than  the  Control  Center 
HMi  when  you  make  your  additions  to  the  macro,  simply  move  to  that 

work  surface  and  continue  appending  to  the  macro.  You  can  then  edit 
the  macro  to  remove  the  keystrokes  used  to  reach  the  work  surface. 

For  example,  if  your  macro  works  from  the  Browse  screen,  place  the 
cursor  in  the  Data  panel,  choose  the  Append  to  macro  option,  and 
then  edit  out  the  F2  Data  keystroke  later. 


Insert  User-Input  Break 

dBASE  IV  macros  are  flexible  enough  to  let  you  or  someone  else  enter  infor¬ 
mation  while  the  macro  is  playing  back.  When  a  user-input  break  occurs,  the 
macro  stops  playing,  and  you  can  then  enter  data  or  perform  other  actions. 
To  resume  playing  back  the  macro,  press  ShiftyyFlO  Macros. 

You  could  use  a  user-input  break,  for  example,  to  construct  a  macro  that  sets 
up  a  complicated  calculated  field,  waits  for  you  to  enter  today’s  interest  rate, 
then  continues. 

To  insert  a  user-input  break,  first  begin  recording  a  macro.  When  you  reach 
a  point  where  you  want  to  be  able  to  insert  some  data  later,  press 

Shift-FlO  Macros  and  select  the  Insert  user-input  break  option. 

You  can  insert  several  user-input  breaks  in  one  macro.  When  you  have  fin¬ 
ished  recording  the  macro,  press  Ctrl-End  to  complete  entering  the  macro. 
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Modify 


This  option  lets  you  change  an  existing  macro  with  a  special  version  of  the 
word  wrap  editor. 


Name 

Choose  this  option  if  you  want  to  change  the  name  of  an  existing  macro. 

After  pressing  the  key  that  activates  the  macro,  you  can  change  its  name. 
Press  ♦♦when  you  have  made  the  change. 

Delete 

You  can  delete  macros  with  this  option.  First  choose  the  option,  then  press 
the  key  that  activates  this  macro.  You  will  be  asked  to  confirm  your  intention 
to  delete  this  macro.  If  you  enter  y  or  Yand  then  press  ♦♦,  the  macro  will  be 
deleted.  The  macro  display  table  disappears  from  the  screen,  and  you  will  be 
back  on  the  Macros  menu. 

Copy 

Choose  this  option  to  copy  a  macro  to  a  new  slot  in  the  macro  display  table. 

After  you  have  selected  the  macro  to  copy,  press  •*-»>.  The  macro  display  table 
for  the  current  library  appears  on  the  screen.  Press  the  key  that  plays  back 
the  macro.  The  macro  will  be  copied  into  the  current  library. 

Play 


If  you  forget  which  key  is  assigned  to  what  macro,  use  the  Play  option  to 
show  the  macro  display  table  and  pick  the  macro  by  its  name.  Place  the  cur¬ 
sor  on  the  macro’s  slot  and  p  ess  •*-»►.  The  Macro  menu  will  disappear  and 
the  m aero  will  play. 


Dot  prompt  equivalent  command 
PLAY  MACHO  <macro  rams> 


Talk 


This  option  displays  the  macro  steps  in  the  message  line  as  the  macro  is 
being  executed. 

This  option  is  not  related  to  the  dot  prompt’s  SET  TALK  command. 
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Load  Library 

Use  this  option  to  load  a  new  library  of  macros.  If  you  have  changed  the  cur¬ 
rent  library,  you  will  be  asked  to  save  it  first.  Then  you  can  choose  a  new 
library  from  a  list  of  available  libraries. 


Dot  prompt  equivalent  command 
RESTORE  MACRDS  FROM  <rrBcro  file> 


Save  Library 

Use  this  option  to  save  the  current  library  of  macros.  After  you  select  this 
option,  you  can  change  or  accept  the  current  macro  library’s  name.  Then 
press  and  the  library  will  be  saved. 


nDot  prompt  equivalent  command 
SAVE  MACROS  TO  <racro  file> 


The  Shift-FlO  Macros  Menu 


The  menu  displayed  when  you 
press  Shift-FlO  Macros  is  shorter 
than  the  one  displayed  at  the  Con¬ 
trol  Center  and  does  not  display  the 
macro  display  table.  You  can  use 
the  Shift-FlO  Macros  menu  to 
record  and  play  macros  from  any¬ 
where  in  dBASE  IV. 


Begin  Recording 

Use  this  option  to  begin  recording  a  macro.  You  are  asked  to  indicate  which 
key  you  want  to  assign  for  playing  back  the  macro.  Enter  a  letter  between  a 
and  zor  a  function  key  from  FI  to  F9. 

You  are  then  asked  to  enter  a  name  for  the  macro.  Enter  a  name  of  up  to  ten 
characters  and  press  •«-►.  If  the  key  you  selected  already  has  a  macro  assigned 
to  it,  you  can  accept  or  modify  the  name  previously  given  to  the  macro. 

After  you  enter  or  modify  the  macro  name  and  press  the  Macros  menu 
disappears  from  the  screen  and  the  next  keystrokes  you  enter  are  captured 
to  the  macro.  To  finish  recording  the  macro,  press  Shift-FlO  Macros.  The 
Macros  menu  will  display  again,  and  you  can  select  the  End  recording 
option. 
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End  Recording 

This  option  lets  you  finish  recording  a  macro.  The  keys  you  press  to  select 
this  menu  (Shift-FlO  Macros-e)  are  not  recorded  as  part  of  the  macro. 


NOTE 

If  you  want  to  wake  a  macro  that  itself  uses  the  Macros  menu,  you 
will  need  to  do  so  from  the  Control  Center.  Select  the  Tools  menu,  the 
Macros  menu,  and  the  Modify  option.  You  can  then  use  the  special 
macro  editing  style  to  insert  keystrokes  to  use  the  Macros  menu  as 
part  of  a  macro. 


Insert  User-Input  Break 

Use  this  option  to  insert  a  pause  in  a  macro,  during  which  you  can  enter 
data  when  the  macro  is  playing.  To  return  to  playing  the  macro,  press 
Shift-FlO  Macros  and  the  macro  will  continue  playing. 


Play 


Use  this  option  to  play  back  a  macro.  After  you  select  this  option,  enter  any 
letter  a  through  z or  a  function  key  from  FI  through  F9. 


The  Import  Menu 


The  Import  menu  lets  you  bring  in 
data  from  a  non-dBASE  IV  file. 


After  you  choose  this  option  from  the  Tools  menu,  a  submenu  of  file  types 
appears.  Choose  one  of  these  types  and  then  select  a  filename  from  the  list  of 
possible  filenames  that  appears. 

If  importing  this  file  would  cieate  a  file  with  the  same  name  as  one  already 
in  the  current  directory,  a  prompt  offers  you  the  choice  of  writing  over  the 
existing  file  or  cancelling  this  operation. 

If  you  choose  to  proceed,  the  file  will  be  imported  and  given  a  .dbf 
extension. 


RapidFile 


Use  this  option  to  import  RapidFile  data.  After  choosing  this  option,  you  will 
see  a  list  of  RapidFile  files,  shown  with  their  .rpd  extensions. 


13-8 


TOOLS 


PAGE:  9  SESS:  5  Tue  day  17  23:22:29  1988 
K2/al  I  J obi/CLS_manhat /GRP_^nanhat / JOB _jnanusemen/DI  V_umchapl3 

dBASE  II 


Use  this  option  to  import  dBASE  II  data.  In  order  to  import  a  dBASE  II  file, 
you  must  change  its  .dbf  extension  to  .db2  before  using  the  Import  menu. 
After  renaming  the  files  and  choosing  this  option,  you  will  see  a  list  of 
dBASE  II  files,  shown  with  their  .db2  extensions. 

Framework  II 

Use  this  option  to  import  data  from  Framework  II  spreadsheet  or  database 
files.  After  choosing  this  option,  you  will  see  a  list  of  Framework  II  files, 
shown  with  their  .fw2  extensions. 


Lotus  1-2-3 

You  can  use  this  option  to  import  data  from  the  new  Lotus  1-2-3  files  that 
have  the  .wkl  extension.  To  bring  data  from  the  older  .wks  Lotus  1-2-3  files, 
use  the  Copy  records  from  non-dBASE  file  option  on  the  database  design 
screen’s  Append  menu. 


PFS:File 

Use  this  option  to  import  PFS:File  data.  After  choosing  this  option,  you  will 
see  a  list  of  all  files  that  have  no  extensions.  You  will  need  to  make  sure  you 
choose  an  actual  PFS:File  file. 

When  a  PFS:File  file  is  imported,  .dbf,  ,vue,  and  .fmt  files  are  created. 


The  Export  Menu 

The  Export  menu  lets  you  export 
files  to  the  universe  outside  of 
dBASE.  After  you  choose  the  type 
of  file,  you  will  see  a  list  of 
dBASE  IV  .dbf  files.  The  correct 
extensions  are  added  automatically 
to  the  exported  files. 


RapidRIe 


Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  RapidFile  .rpd  file. 
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dBASE  II 


Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  dBASE  II  .db2 
file. When  you  have  moved  the  new  ,db2  file  to  the  dBASE  II  system,  then 
rename  it  to  have  a  .dbf  extension.  Do  not  rename  the  .db2  file  if  there  is  a 
chance  you  might  overwrite  the  original  .dbf  file. 


Framework  II 

Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  Framework  II  .fw2  file. 
The  file  exported  will  be  a  database  file. 


Lotus  1-2-3 

Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  Lotus  1-2-3  .wks  file. 
You  can  then  use  Lotus  1-2-3  to  convert  the  .wks  file  into  a  .wkl  file  if 
necessary. 


VisiCalc 

Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  VisiCalc  .dif  file. 

PFS:File 


Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  PFS:File  file.  The  new 
file  will  not  have  an  extension. 


SYLK-Multiplan 

Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  Multiplan  file.  The 
new  file  will  not  have  an  extension. 


Text  Fixed-length  Fields 

Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  .txt  SDF  file. 


Blank  Delimited 

Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  .txt  blank-delimited 
file. 


Character  Delimited 

Choose  this  option  to  export  a  dBASE  IV  .dbf  file  to  a  txt  character- 
delimited  file.  You  may  specify  a  different  character  for  the  delimiter  than 
the  one  shown  in  the  menu. 
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You  can  read  more  about  these  file  types  in  the  sections  about  the  EXPORT 
and  COPY  commands  in  Language  Reference. 


The  DOS  Utilities  Screen 

The  DOS  utilities  screen  offers  many  useful  options  for  managing  files.  The 
work  surface  provides  two  useful  tools,  a  files  list  and  a  directory  tree.  The 
files  list  helps  you  work  with  files,  while  the  directory  tree  shows  all  your 
directories. 


The  Files  List 

Figure  13-3  shows  the  DOS  utilities  screen  with  a  list  of  files  displayed  on  the 
work  surface.  This  list  presents  the  names  of  files  in  a  particular  directory, 
when  they  were  created  or  last  updated,  and  how  large  they  are. 


ACCT  REC  DBF 
ACCT_REC  MDX 
ACCT_REC  PRG 
ADDBOOK  SCR 
ADDCODES  UPD 
ALLNAMES  FRM 
AREACODE  PRG 
BACK_RES  BAK 
BACK  RES  DBO 
BACK  RES  PRG 


Z0.488 
Z4.4Z6 
Z,  075 
3.637 
Z.  381 
Z1.B43 
Z,  688 
Z.5Z4 
Z.  588 


Apr  5.1388 
May  17.1988  11 '37a 
Apr  Z1.1988  9' 17a 

May  1Z. 1988  lZ'lBp 
May  16.1988  10' 53a 
May  1Z. 1988  lZ'ZZp 
Apr  18.1988  8'3Za 

May  ZB . 1 988  9'Zla 
May  Z0.1988  9'Zla 
May  IB. 1988  9=Z3a 


Z.048 

ZZ.5Z8 

Z4.576 

4.036 

4.096 

4.096 

ZZ.5Z8 

4.096 

4.096 

4.B96 


Files' ».  »* 


Sorted  by  Nana 


Position  selection  bar'ti  Mark  file'*-*  Directories' F9 


Figure  13-3  The  files  list 

The  Size  column  shows  the  amount  of  space  taken  up  by  the  data  in  a  file. 
The  names  of  directories  are  indicated  by  a  <  DIR>  marker  in  the  Size 
column. 

The  Space  Used  column  shows  the  space  needed  on  the  disk  to  store  each 
file.  This  disk  space  depends  on  the  cluster  size  for  the  current  disk.  Values 
in  this  column  are  always  equal  to  or  greater  than  the  numbers  in  the  Size 
column.  For  example,  if  your  disk  has  a  cluster  size  of  2,048  bytes,  then  any 
file,  no  matter  how  small,  takes  up  at  least  2,048  bytes. 

The  Attrs  column  tells  you  whether  an  attribute  has  been  set  for  the  files. 
Possible  file  attributes  are  Archive,  Hidden,  Read-Only,  and  System.  If  an 
attribute  for  a  file  is  not  set,  that  column  contains  a  small  diamond.  You  can 
learn  more  about  file  attributes  from  your  DOS  manual. 
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The  two  rows  at  the  bottom  of  the  list  show  the  number  and  total  size  of  all 
files  in  the  list,  as  well  as  the  size  and  number  of  marked  files.  Marked  files 
are  those  you  choose  to  operate  on  as  a  group.  For  example,  you  could 
choose  six  files  and  then  copy  or  delete  them  all  at  once.  To  mark  or  unmark 
the  current  file,  press 

Navigating  the  Files  List 

You  can  move  up  and  down  the  list  of  files  by  pressing  T,  |,  PgUp,  PgDn, 
Home,  or  End.  You  can  display  the  files  in  another  directory  by  placing  the 
cursor  on  the  name  of  the  directory  and  pressing  *-»•.  The  files  list  will  dis¬ 
play  the  names  of  files  in  the  directory  you  have  just  chosen. 

To  see  the  files  in  the  directory  containing  the  current  file,  place  the  cursor 
on  the  <  parent  >  marker  and  press  <*-►.  If  you  press  ♦♦on  each 
<  parent >  marker,  you  eventually  work  your  way  back  to  the  root 
directory. 


The  Directory  Tree 

There  is  a  faster  way  to  move  from  one  directory  to  another.  You  can  use 
F9  Zoom  to  display  a  directory  tree.  Press  F9  Zoom  from  any  place  in  the 
files  list,  and  dBASE  IV  will  replace  the  files  list  with  a  display  of  the  directo¬ 
ries  on  the  current  disk.  You  can  return  to  the  files  list  by  pressing  F9  Zoom 
once  more. 

The  directory  tree  contains  a  diagram  of  your  disk’s  directories  and  subdirec¬ 
tories.  The  root  directory  appears  at  the  top  of  the  tree.  Branching  off  from 
the  vertical  line  that  descends  from  the  root  directory  are  the  directories. 
Subdirectories  are  shown  as  branches  below  the  directories. 


Figure  13-4  The  directory  tree 
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In  Figure  13-4,  for  example,  the  root  directory  is  C:\,  a  DOS  directory  is 
shown  under  the  root  directory,  and  a  Utility  directory  is  shown  under  the 
DOS  directory.  The  Utility  directory  has  a  small  triangle  next  to  it.  This  indi¬ 
cates  that  the  Utility  directory  is  the  one  with  filenames  that  were  most 
recently  shown  in  the  files  list. 

You  can  move  up  and  down  the  directory  tree  by  pressing  i,  PgUp,  PgDn, 
Home,  or  End.  You  can  display  the  files  in  a  directory  by  placing  the  cursor 
on  the  name  of  the  directory  and  pressing  •«-►.  The  directory  tree  is  replaced 
by  the  files  list,  which  displays  the  names  of  files  in  the  newly  chosen 
directory. 

At  the  very  top  of  the  directory  tree  is  a  marker  for  the  current  disk  drive.  In 
Figure  13-4,  this  drive  marker  is  <  C:>  .  You  can  change  to  a  different  disk 
drive  by  placing  the  cursor  on  the  drive  marker  and  pressing  •*-*.  A  list  of 
other  possible  drives  appears,  and  you  can  select  the  one  you  want.  The 
directory  tree  then  displays  the  directories  in  the  newly  chosen  drive. 


The  DOS  Utilities  Menu  Bar 

The  DOS  utilities  menu  bar  is  composed  of  the  following  menus:  DOS,  Files, 

Sort,  Mark,  Operations,  and  Exit. 


The  DOS  Menu 

The  DOS  menu  lets  you  use  DOS 
commands  and  manage  your  files 
without  leaving  dBASE  IV. 


Perform  DOS  Command 

This  option  lets  you  issue  a  DOS  command  directly  from  dBASE  IV. 

After  you  choose  this  option,  enter  a  DOS  command  such  as  CHKDSK  or 
DIR  into  a  prompt  box  and  press  <-».  The  command  will  be  carried  out,  and 
any  screen  output  will  appear  on  the  work  surface. 

When  you  finish,  press  any  key  and  the  list  of  files  will  display  again. 

Go  to  DOS 

You  can  clear  the  screen  and  go  to  a  special  DOS  window  with  this  option. 
This  window  lets  you  use  the  full  screen  to  perform  DOS  operations  or  run 
other  programs,  without  leaving  dBASE  IV. 

If  you  have  marked  any  files,  a  prompt  box  first  announces  that  these 
marked  files  will  no  longer  be  marked  when  you  return  from  DOS.  If  this  is 
acceptable,  press  the  Proceed  button.  If  you  are  not  ready  to  give  up  your 
file  marks,  press  the  Cancel  button. 
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When  you  proceed  with  this  option,  the  DOS  utilities  work  surface 
disappears  from  the  screen  and  is  replaced  by  the  familiar  DOS  prompt.  You 
can  then  enter  commands  at  the  DOS  prompt. 

After  completing  what  you  want  to  do  with  DOS,  you  return  to  dBASE  IV  by 
typing  exit  and  pressing  <«-►.  dBASE  IV  modifies  the  DOS  prompt  to  remind 
you  of  this. 


nDot  prompt  equivalent  command 
RLN  CCmWD 


Set  Default  Drive:directory 

You  can  change  the  drive  and  directory  that  dBASE  IV  considers  the  default. 
New  files  will  be  automatically  stored  on  this  new  default  drive  and 
directory. 

After  you  select  this  option,  a  prompt  box  asks  for  the  name  of  the  new 
default  drive  and  directory.  You  can  type  in  the  name  and  then  press  •«-»-.  You 
can  also  press  Shift-FI  Pick  to  display  the  directory  tree.  Place  the  cursor  on 
the  name  of  the  directory  you  want  for  the  default  and  press  *-*•. 

You  can  always  tell  which  is  the  current  default  drive/directory  by  looking  at 
the  status  line.  For  example,  in  Figure  13-4,  the  current  default  drive/direc¬ 
tory  is  C:\DBASE\SAMPLES . 

The  Files  Menu 

This  menu  lets  you  select  special 
groups  of  files  to  put  in  the  list 
of  files  on  the  DOS  utilities  work 
surface. 


Change  Drive  idirectory 

Use  this  option  to  show  the  files  in  a  different  drive  or  directory.  Press  -«-*• 
and  type  in  the  desired  drive  and  directory.  Then  press  to  complete  your 
entry. 

You  can  also  change  the  drive  and  directory  by  selecting  this  option  and 
pressing  Shift-FI  Pick  to  display  the  directory  tree.  Place  the  cursor  on  the 
name  of  the  directory  with  files  you  want  to  see  and  press  *-►. 


NOTE 

Changing  this  option  only  determines  which  files  appear  in  the  files 
list.  This  option  does  not  affect  the  default  drive  or  directory  described 
under  Set  default  dri vc:di rectory 
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Display  Only 

Use  this  option  to  filter  the  file*  in  the  list  of  files.  You  could,  for  example, 
display  only  .dbo  files  in  the  list  of  files  by  entering  *.dbo  in  this  option.  Tb 
display  every  file  in  a  directory,  enter  *.*  or  press  *-►  if  the  option  is  empty. 

The  current  choice  for  the  Display  only  filter  is  shown  on  the  left  side  of  the 
screen,  below  the  files  list. 


■  TIP 

m  Tb  quickly  mark  groups  of  files,  you  may  find  it  useful  to  combine  the 
i  Display  only  optioofGnth  th(\Mark  a /^optTon  orTThe^ Ma ri'/m  enu.  For) 
/'example,"  to  marFall  the  .prg  files,  you  could  choose  to  display  only  / 
/  *prg  files,  then  choose  the  Mark  all  option.  If  you  then  display  ally 
y^files,  every  .prg  file  will  be  marked. _ _ _ _ _ J 


The  Sort  Menu 

The  Sort  menu  lets  you  change  the 
order  in  which  the  files  are  listed. 
Only  a  single  sort  option,  indicated 
by  the  word  ON,  can  be  chosen  at  a 
time.  The  current  sorting  choice  is 
shown  on  the  right  side  of  the 
screen,  below  the  files  list. 


Name 

Use  this  option  to  sort  files  by  name. 

Extension 

This  option  lets  you  sort  files  by  their  extensions,  such  as  .exe  or  .dbf. 

Date  &  time 

This  option  sorts  first  by  date,  then  by  time 

Size 

Use  this  option  to  sort  files  by  size. 
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The  Mark  Menu 


The  options  in  this  menu  let  you 
quickly  change  the  way  the  files  are 
m  arked. 


You  can  only  mark  files  when  they  appear  in  the  list.  Once  you  have  marked 
a  file,  however,  it  remains  marked  until  either  you  return  to  the  Control  Cen¬ 
ter  or  choose  Go  to  DOS. 

Mark  All 

This  option  marks  all  files  displayed  in  the  list,  even  if  they  are  scrolled  out 
of  view. 

Unmark  All 

Use  this  option  to  clear  the  list  of  all  marks.  This  is  a  prudent  action  to  take 
when  you  have  finished  an  operation  and  you  want  to  ensure  that  none  of 
the  files  are  still  marked. 

Reverse  Marks 

This  option  lets  you  swap  which  files  are  marked  and  which  are  not.  You 
might,  for  example,  mark  all  the  .dbf  files  and  copy  them  to  another  direc¬ 
tory.  Then  you  could  reverse  the  marks  and  copy  all  the  other  files  to  a  dif¬ 
ferent  directory. 


The  Operations  Menu 

This  menu  contains  operations  you 
can  apply  to  the  files  in  the  list  of 
files.  The  Delete,  Copy,  Move,  and 
Rename  options  display  a  prompt 
box  that  lets  you  choose  whether  to 
apply  these  operations  to  the  cur¬ 
rent  file,  the  marked  files  shown  on 
the  files  list,  or  all  the  displayed 
files. 


The  Marked  files  option  only  applies  to  marked  files  that  are  in  the  current 
files  selection.  For  example,  if  any  marked  files  are  excluded  from  the  files 
list  because  of  a  Display  only  filter,  those  files  are  not  affected  by  these  oper¬ 
ations.  This  safety  feature  prevents  you  from  inadvertently  applying  an  opera¬ 
tion  to  files  that  are  marked  but  not  displayed. 
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WARNING 


If  you  have  a  long  files  list,  some  marked  files  may  not  appear  on  the 
screen  because  all  the  files  will  not  fit  in  the  files  list  at  one  time.  Be 
careful  to  keep  track  of  which  files  are  marked  before  carrying  out 
any  operation. _ _ _ _ _ __ _ 


If  the  cursor  is  on  the  name  of  a  directory  when  you  choose  an  operation 
(except  for  View  and  Edit),  that  operation  will  be  applied  to  the  whole 
directory  if  you  select  the  Single  file  option  from  the  prompt  box. 

Delete 

Choose  the  Delete  option  and  specify  whether  you  want  to  delete  the  current 
file,  the  marked  files,  or  all  the  files  in  the  files  list. 

A  prompt  box  specifies  which  files  you  are  about  to  delete.  You  can  cancel 
or  continue  the  deletion  by  moving  the  highlight  to  either  the  Proceed  or 
Cancel  button  and  pressing  «-»•. 

You  may  also  delete  the  current  file  by  pressing  Del. 

Copy 

Choose  this  option  to  copy  files  to  a  different  directory. 

This  option  displays  a  prompt  box  that  lets  you  choose  between  copying  the 
current  file,  all  the  marked  files,  or  all  the  displayed  files. 

After  you  make  this  choice,  another  prompt  box  lets  you  enter  the  destina¬ 
tion  drive  and  directory.  The  destination  of  the  most  recent  copy,  move,  or 
rename  operation  is  presented  as  the  default.  You  can  accept  this  destination 
by  pressing  You  can  also  type  in  a  new  destination  or  use  Shift-FI  Pick  to 
select  a  new  destination  from  the  directory  tree. 

If  you  are  copying  a  single  file,  press  -*-►  to  move  the  cursor  to  the  filename 
in  the  prompt  box.  The  filename  highlighted  in  the  files  list  is  presented  as 
the  default,  which  you  can  modify. 

If  you  are  copying  Marked  files,  press  «*-*•  to  move  the  cursor  to  the  empty 
filename  space  in  the  prompt  box.  You  should  enter  a  filename  that  contains 
the  asterisk  (*)  wildcard  in  the  basic  filename,  its  extension,  or  both.  Other¬ 
wise,  the  marked  files  will  all  be  copied  into  the  one  file  named  in  the 
prompt  box. 

Suppose  you  want  to  copy  Salesl.dbf  and  Sales2.fmt  to  a  directory  named 
Test.  If  you  enter  the  target  filename  as  *.*,  then  the  files  will  be  copied  with 
the  same  names  to  the  Test  directory.  If  you  enter  the  target  filename  as  *.tst, 
then  the  copies  of  the  two  files  in  the  Test  directory  will  be  named  Salesl.tst 
and  Sales2.tst.  If  you  enter  the  target  filename  as  Salesold.*,  then  the  copies 
will  be  named  Salesold. dbf  and  Salesold. fmt. 

When  you  have  entered  the  path  and  name  as  you  want  them,  press  Ctrl-End 
to  carry  out  the  operation. 


USING  THE  MENU  SYSTEM 


13-17 


JOBNAtlE:  PAGE:  18  SESS:  5  Tue  May  17  23:  22:  29  1  988 

@tate/d  i  sk2/a I l j  obz/CLS_manhat/GRP_manhat/JOB_manusemen/DI V_umchapl3 

You  will  not  be  allowed  to  copy  a  file  onto  itself,  and  you  will  be  warned  if 
you  are  about  to  copy  a  file  onto  a  different  file  with  the  same  name. 

You  may  also  copy  the  current  file  by  pressing  F8  Copy.  A  prompt  box  will 
display  so  you  can  enter  the  path  and  name  for  the  copy  of  the  current  file. 

Move 

Use  the  Move  option  to  quickly  transfer  one  or  more  files  to  another  direc¬ 
tory.  After  you  choose  this  option,  a  prompt  box  appears.  This  prompt  box 
works  like  the  one  described  under  the  Copy  option  of  this  menu. 

You  may  also  move  the  current  file  by  pressing  F7  Move.  A  prompt  box  will 
display  and  you  can  enter  the  path  and  name  for  the  new  location  for  the 
current  file. 

After  you  press  Ctrl-End  to  complete  the  move,  the  specified  files  will  be 
removed  from  the  current  directory  and  placed  in  the  destination  directory. 

Rename 

You  can  rename  one  or  more  files  with  this  option.  A  prompt  box  is 
displayed  so  you  can  enter  the  destination  filename. 

Suppose  you  want  to  rename  two  files  Salesnew .dbf  and  Salesnew.dbt.  You 
could  enter  the  destination  filename  as  Salesold.*.  This  would  rename  these 
files  to  Salesold. dbf  and  Salesold.  dbt. 

You  will  not  be  allowed  to  rename  a  file  as  itself,  and  you  will  be  warned  if  a 
file  with  that  name  already  exists.  If  you  choose  the  name  of  a  directory,  this 
option  can  be  used  to  rename  the  directory. 


View 

Use  this  option  to  display  the  contents  of  the  highlighted  file.  The  file’s  data 
appears  in  the  display  area  where  you  can  quickly  review  it. 

For  files  that  are  not  pure  text,  non-textual  characters  are  filtered  out,  elimi¬ 
nating  the  annoying  beeps  and  strange  characters  other  display  utilities  pro¬ 
duce  when  they  try  to  show  a  binary  file. 

The  display  pauses  after  each  screenful  of  data.  You  can  press  Spacebar 
to  view  the  next  screen  of  text,  or  press  to  choose  a  scrolling  display 
that  does  not  pause  after  each  screen.  During  the  scrolling  display,  press  ♦-*• 
or  Spacebar  to  suspend  the  scrolling.  Press  Esc  at  any  time  to  cancel  the 
display. 

Edit 

This  option  allows  you  to  use  the  program  editor  on  the  currently  selected 
file. 
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WARNING 

Do  not  try  to  edit  files  that  are  not  ASCII  text  files.  The  Edit  option 
is  designed  to  work  with  files  containing  dBASE  IV  code,  such  as 
files  with  .fmt,  .frg,  .lbg,  .prg,  or  .prs  extensions.  You  can  also  edit 
batch  files  (.bat)  or  text  files  (.txt). 


Do  not  attempt  to  edit  other  dBASE  IV  files  or  files  with  .exe  or  .com 
extensions.  If  you  want  to  edit  files  produced  with  non-dBASE  IV 
word  processors,  make  sure  the  file  is  in  ASCII  format.  If  you  want 
to  edit  dBASE  IV  memo  field  files  (those  with  .dbt  extensions)  use 
the  Edit  screen,  not  this  option.  Otherwise,  the  .dbf  file  may  not  be 
able  to  find  the  proper  memo  field  text. 


The  Exit  Menu 


Use  this  menu  to  exit  from  the  DOS 
utilities  screen  back  to  the  Control 
Center. 


The  Protect  Data  Screen 

The  Protect  data  option  displays  a  new  menu  bar.  You  can  use  this  menu 
bar  to  control  which  users  have  access  to  what  files. 

A  warning  box  tells  you  that  this  option  permanently  assigns  passwords  to 
your  data.  Use  the  Protect  option  only  when  you  are  thoroughly  familiar  with 
the  dBASE  IV  security  system. 

If  you  purchased  the  dBASE  IV  Developer’s  Edition,  see  the  “dBASE  Secu¬ 
rity”  chapter  in  Networking  with  dBASE  IV.  If  you  purchased  dBASE  IV,  see 
the  “dBASE  Security”  chapter**? in  Advanced  Ibpics. 


The  Settings  Menu  Bar 

The  Settings  menu  bar  has  two  menus,  Options  and  Display.  The  Options 
menu  lets  you  customize  the  way  dBASE  IV  displays  and  handles  data.  The 
Display  menu  lets  you  change  the  colors  assigned  to  different  parts  of 
dBASE  IV. 
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The  Options  Menu 


The  choices  on  the  Options  menu 
are  a  selection  of  the  most  com¬ 
monly  used  dBASE  IV  settings. 
These  settings  are  also  available  in 
the  larger  selection  of  settings 
offered  by  the  dot  prompt’s  full¬ 
screen  SET  command. 


You  can  disable  the  warning  bell  by  setting  the  Bell  option  to  OFF.  The 
Century,  Date  order,  and  Date  separator  options  determine  how  dates  dis¬ 
play.  The  Carry  and  Confirm  options  affect  how  data  is  entered  from  the 
Browse  or  Edit  screens.  Decimals  determines  how  numbers  are  displayed. 
The  Exact  option  requires  comparisons  to  match  exactly.  Memo  width 
adjusts  the  display  width  of  memo  fields,  and  Margin  specifies  the  amount  of 
space  your  printer  will  leave  before  printing  unformatted  text.  (This  is  the 
same  as  the  Offset  from  left  option  on  the  Print  menu.) 

Deleted  tells  dBASE  IV  to  ignore  records  marked  for  deletion.  Exclusive 
prevents  other  users  on  a  network  from  sharing  files.  Instruct  turns  on  the 
information  box  and  the  panel  prompt  box,  while  Talk  displays  the  results  of 
operations.  Safety  gives  you  warnings  before  existing  files  are  overwritten  by 
new  ones.  Trap  turns  on  the  Debugger. 

Each  option  on  the  Options  menu  is  also  described  in  the  message  line,  the 
related  Help  screen,  and  under  the  individual  SET  commands  in  Language 
Reference. 


NOTE 


Any  changes  you  make  on  the  Options  menu  will  alter  the  way 
dBASE  IV  works  in  the  current  session  only.  1b  make  changes  that 
last  from  session  to  session,  you  will  need  to  leave  dBASE  IV and  run 
the  DBSETUP  command. 

If  you  didn ’t  put  DBSETUP  on  your  hard  disk  when  you  installed 
dBASE  IV,  you  can  cooy  it  now.  DBSETUP  will  be  on  the  first  disk 
used  to  install  dBASE  IV. 


The  Display  Menu 


The  Display  menu  uses  the  same 
color  palette  as  the  Display  option 
in  the  Words  menu.  You  can  read 
how  the  palette  works  in  Chapter  4, 
“Editing.” 


Use  the  Display  menu  to  assign  colors  to  different  parts  of  your  dBASE  IV 
screens.  You  can,  for  example,  make  the  status  bar  a  certain  color.  You  can 
also  change  the  color  of  the  menus  or  the  appearance  of  Browse  screens. 
You  can  read  more  about  how  colors  are  assigned  under  the  SET  COLOR 
command  in  Language  Reference. 
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The  Exit  Menu 


The  Exit  menu  returns  you  to  the 
Control  Center. 
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dBASE/Chart- 
Master  Bridge 


Introduction 

Data  can  often  be  understood  better  when  presented  in  a  chart.  dBASE  IV 
contains  a  customized  dBASE  program  called  dBASE/Chart-Master  Bridge 
that  can  help  you  make  charts  with  an  external  package  named 
CHART-MASTER. 

If  you  have  CHART-MASTER,  you  can  use  dBASE/Chart-Master  Bridge  to 
graph  dBASE  IV  data.  If  you  don’t  have  CHART-MASTER,  you  can  obtain  it 
from  Ashton-Tate  or  your  local  software  dealer. 

dBASE/Chart-Master  Bridge  helps  you  create  any  type  of  CHART-MASTER 
chart.  You  can  define  chart  titles  and  labels,  choose  fields  and  filters, 
describe  how  you  want  the  dBASE  IV  file  converted  to  a  CHART-MASTER 
file,  and  automatically  generate  chart  files. 

Although  dBASE/Chart-Master  Bridge  works  only  with  database  files,  you  can 

create  a  database  file  from  a  dBASE  IV  view  and  then  use - 

dBASE/ Chart-Master^ 

^Bridge  with  the  newly  created  database  file.  dBASE/Chart-Master  Bridge 
comes  with  a  built-in  help  system. 

You  can  reach  CHART-MASTER  in  one  of  two  ways: 

■  From  the  Control  Center,  place  the  cursor  over  the  name  Chrtmstr  in 
the  Applications  panel  and  press  <-*. 

If  you  do  not  see  the  name  Chrtmstr  in  the  Applications  panel,  you 
must  add  it  to  the  current  catalog.  Choose  the  Add  file  to  catalog  option 
from  the  Catalog  menu. 

■  From  the  dot  prompt,  type  lf)o  chrtmstr  and  press 


© 


Using  the  dBASE/Chart-Master  Bridge  Menu  Bar 

The  dBASE/Chart-Master  Bridge  menu  bar  contains  four  menus: 
Database,  Chart,  Help,  and  Exit. 
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The  Database  Menu 


The  Database  menu  helps  you 
select  a  database  file  or  apply  a  fil¬ 
ter  condition  to  the  records  in  the 
file. 


Select  Database  File 

Use  this  option  to  select  a  database  file  from  the  files  in  the  current  direc¬ 
tory.  You  must  pick  a  file  before  making  a  chart. 

Define  a  Filter  Condition 

Enter  a  valid  dBASE  IV  filter  condition.  This  filter  condition  will  select  only 
those  records  that  satisfy  the  condition.  You  can  read  more  about  filter  con¬ 
ditions  in  the  SET  FILTER  TO  entry  in  Language  Reference. 


The  Chart  Menu 


The  Chart  menu  lets  you  specify 
the  chart’s  labels,  titles,  chart  type, 
and  variables. 


Identify  Fields  as  Variables 

Use  this  option  to  select  a  field  from  a  list  of  fields  in  the  current  database 
file.  This  field  will  be  plotted  on  the  chart.  You  can  pick  up  to  eight  numeric 
fields,  but  they  cannot  be  floating  point. 

Display  Observation  Labels 

Use  this  option  to  indicate  what  kind  of  observation  labels  you  want.  You 
may  use  standard  labels,  labels  taken  from  data  in  the  database  fields,  or  no 
labels  at  all.  Thes;  labels  are  placed  along  the  X  axis  of  the  chart. 

Use  Default 

This  option  creates  preset  observation  labels  for  the  X  axis  called  Obsl, 

Obs2,  and  so  on. 

Derive  from  Field 

Use  this  option  to  make  labels  from  the  value  of  one  of  the  fields  of  the  data¬ 
base.  Acceptable  field  types  are  character,  date,  or  numeric.  Numeric  fields 
may  have  up  to  two  decimal  places. 

No  Observation  Labels 

This  option  specifies  no  X-axis  labels  on  the  chart. 
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Create/Modify  Chart  Titles 

Use  this  option  to  define  the  chart  title,  axis  labels,  and  legend  titles.  A 
prompt  box  lets  you  enter  up  to  four  title  lines  for  the  chart,  with  up  to  two 
labels  for  the  X  axis  and  up  to  two  labels  for  the  Y  axis.  You  can  also  add  up 
to  eight  legend  titles. 

If  you  are  using  fields  as  variables  options,  you  can  also  enter  a  title  for  each 
variable  field. 

Pick  Chart  Type 

Use  this  option  to  select  what  kind  of  chart  you  want  to  make.  You  can 
choose  from  seven  types  of  charts:  line,  pie,  clustered  bar,  stacked  bar,  scat¬ 
ter,  and  area. 

Generate  Chart  File 

This  option  creates  the  chart  file,  after  you  enter  a  name  and  location  for  it. 
The  name  of  the  current  database  file  is  used,  by  default,  as  the  name  for  the 
chart  file,  which  has  a  .cht  extension.  You  can  accept  this  name  or  enter  a 
different  one. 


The  Help  Menu 

You  can  use  the  Help  menu  for  on-line  information  about 
dBASE/ Chart-Master 
rBridge.  Choose  from  these  topics: 

■  Using  dBASE/Chart-Master  Bridge 

■  Learning  about  CHART-MASTER 

■  Preparing  a  Database  File  for  CHART-MASTER 

■  Converting  a  Database  File  to  a  Chart  File 

■  Viewing/Editing  Charts 

The  Viewing/editing  charts  option  tells  you  how  to  leave  dBASE  IV  and  use 
a  batch  file  to  run  CHART-MASTER,  so  you  can  view  and  edit  the  chart  gen¬ 
erated  with  dBASE/Chart-Master  Bridge. 


The  Exit  Menu 

Use  the  Exit  menu  to  leave 
dBASE/Chart-Master  Bridge  and 
return  to  the  Control  Center  or  dot 
prompt.  You  can  also  transfer  to 
dBASE  IV’s  queries  design  screen. 


USING  THE  MENU  SYSTEM 
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Save  Changes  and  Exit 

This  option  saves  the  information  about  the  current  chart  in  a  file.  The  file  is 
automatically  given  the  name  of  the  current  database  file,  followed  by  a  .cht 
extension. 

Abandon  Changes  and  Exit 

This  option  discards  any  changes  made  to  the  current  chart  information.  You 
are  asked  to  confirm  that  you  want  to  abandon  your  changes. 

Transfer  to  Query  Design 

Use  this  option  to  create  a  query.  Then  choose  the  Write  view  as  database 
option  from  the  Layout  menu  on  the  queries  design  screen.  When  you 
return  to  dBASE/ Chart-Master  Bridge,  you  can  make  a  chart  from  the  new 
database  file. 
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Appendix  A: 
Menu  Trees 


Menu  Trees 


This  appendix  shows  the  menu  trees  for  dBASE  IV’s  menu  system.  It 
includes  the  Control  Center,  the  design  screens,  and  the  Browse  and  Edit 
screens. 


The  Control  Center 

Catalog  Tools 


1  Browse 

h 

— r 

— >Smpm 

▼ 

a-s 

pidit 

I  LwH  1 :  Manu  or  Control  Cantv  Pval 


n  L*v*<  3:  Submenu 
I _ I  LmI  4:  Submenu 
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A-1 


A-2 


Control  Center  Menu  Bar 


Catalog  Tools 


Tools/DOS  Utilities 


USt a/£  me.  Meuv  .system 


A -3 


A  -  4 


Tools/Settings 


Options 


Bel 

Cary 

Cenijry 

Confirm 

Date  order 

Date  separator 

Decimal  places 

Deleted 

Exact 

Exdusi*) 

hstorct 

Margri 

Memowidto 

Safety 

Tdk 

Tn*> 


ON/OFF 

OFF/ON 

OFF/ON 


OFF/ON 

OFF/ON 

ON/OFF 

ON/OFF 


ON/OFF 

ON/OFF 

OFF/ON 


Display 


Display  mode  M0hK3/M0N034/C0L0fl/EGA25'EGA43/VGA25 


>  Standfard  -  All 

>  Normal  text 

>  Messages 

>  Titles 

>  Enhanced  -  All 

>  Highlights 

>  Boxes 

>  Ateft^XnWwvccf  '  Wv 

>  Fields 


>  Perimeter  of  screen 


Exit 

Exit  to  Control  Center 


Monochrome 

[ 

Attributes 

Intensity  (Bold) 

OFFOl 

Underline 

OFF/ON 

Reverse 

OFF/ON 

Bfr* 

OFF/ON 

Color 

Attributes 


^  EXAMPLE 

Foreground 

Background 

Btock 

Black 

Btoe 

Blue 

Green 

Green 

Cyan 

Cyan 

Had 

Red 

Magenta 

Magenta 

Brown 

Brown 

White 

White 

Gay 

Lt  Blue 

Lt  Green 
LtCyan 

Lt  Red 

Lt  Magenta 
Yellow 

Brt  White 

BLINK  OFF 

OOf^lV  3HJ.  "9^/SO 


Protect  Data 


Users 


Login  name 
Password 
Group  name 


Full  name 

Access  level  {} 


Store  user  profile 


Delete  user  from  group 


Files 


New  file 


Group  name 


>  File  access  privileges 


Field  access  privileges 
Access  level  {} 

Establish  field  privileges 


Store  file  privileges 


Cancel  current  entry 


Reports  Exit 


User  information 


File  information 


File  access  levels 

Read  privilege 

(8» 

Update  fwWege 

Extend  privilege 

(»! 

Delete  privilege 

W 

A  -  6 


Browse 


Records 


Fields 


Go  To 


Undo  change  to  record 


Add  new  records 

Mark  record  for  deletton/Clear  deleted  mark 
Blank  record 
Lock  record 

Fdow  record  to  new  position  YES/NO 


Lock  fields  on  left 
Blank  Field 

W 

Freeze  field 

Size  field 

II 

Top  record 

Last  record 

Record  nurrtoer 

II 

Skip 

(10| 

todw  key  search 

II 

Forward  search 

I) 

Backward  search 

II 

Match  capitalization 

NO/YES 

Edit 


Records 


Go  To 


Exit 


Undo  change  to  record 


Add  new  records 

Mark  record  for  deletiorYCIeer  deletion  mark 
Blank  record 
Lock  record 

FcAow  record  to  new  position  YES/NO 


Top  record 

Last  record 

Ftecord  nuntoer 

1) 

SMp 

110} 

Mat  key  search 

1) 

Forward  search 

1) 

Backward  search 

(I 

Match  capitalization 

NO/YES 

Exit 

Transfer  to  Query  Design 
Ftetum  to  <module> 


Exit 


Exit 

T  ransfer  to  Ojery  Design 
Return  to  <module> 


c 


£ 

9s 


1 

£. 

C 

(S\ 

< 

tr- 

X 

% 


Layout  Organize 


* 


Append 


Enter  records  from  keyboard 
Append  records  from  dBASE  file 
>  Copy  records  from  norvdBASE  file 


Go  To 


Copy  records  from  non-dBASE  file 


(Vd) 

dBASE  II 

(db2) 

Framework  II 

(fw2) 

Lotus  1-2-3 

(wks) 

VisiCaJc 

(.df) 

SYLK- Multiplan 

Text  fixed-length  fields 

(t*0 

Blank  delimited 

(txt) 

Character  delimited  f) 

(txO 

Exit 


Save  changes  and  exit 
Abandon  changes  and  exit 


Queries 


CO 

< 


/H 

  A  Aw- 


■■■  mtz 


or\/3w 


Forms 


Layout 


Fields 


Words 


Go  To 


>  Box 

>  Lino 


Use  different  database  file  or  vi 
Edit  description  of  form 
Save  this  form 


Single  line 
Double  line 

Using  specified  character  { } 


Remove  field 
.  Modify  field 


>  Insert  memory  variable 


(  Undo  deletion 

—  -  2* - ^ 

>  Style 

>  Display 

>  Position 

Modify  ruler 

HdenJer 

NO/YES 

Enable  automatic  indent  YES/NO 

Add  line 

Remove  line 

Insert  page  break 

>  Write/read  text  file 

Go  to  line  number 

U 

Forward  search 

u 

Backward  search 

u 

Replace 

{} 

Match  capitalization 

NO/YES 

See  page  A-12 


J> 

-D 


^  .1  nps, - ittt 


A- 1  0 


> 


c 


Reports 


Layout 


>  Quick  layouts 

>  Box 

— 

>  Line 

Use  different  database  file  or  view 

Edit  description  of  report 

Save  this  report 

Fields 


>  Add  field 
Remove  field 

>  Modify  field 

>  Change  hidden  field 


Single  line 
Double  line 

Using  specified  character  { } 


Seepage 
A- 1  2 


Quick  layouts  submenu 


l 


Words 


>  Style 

>  Display 

>  Position 
Modify  ruler 

Hdenier  NO/YES 

Enable  automatic  indent  YESWO 


Add  line 
Remove  line 
Insert  page  break 
>  Writefread  tBxt  tile 


Go  To 


Go  to  line  number 

U 

Forward  search 

{} 

Backward  search 

0 

Replace 

u 

Match  capitalization 

NOWES 

A- 1  4 


Bands 


>  Add  a  group  band 

Remove  group 

>  Modify  group 

Group  intro  on  each  page 

Cyes/no  a 

Open  all  bands 

Begin  band  on  new  page 

NO/YES 

Word  wrap  band 

NO/YES 

Text  pith  for  band 

DEFAULT/PIC  A/ELRE/CONDENSED 

Quality  print  for  band 

P«p^»utr/V«-s/A/o 

Spacing  of  lines  tor  band 

DEFAULT/SINGLE/DOUBLE/TRIPLE 

Page  headings  in  report  intro 

YEStNO 

Add  a  group  band/Modify  group 

Field  value 

{)  | 

Expression  value 

ii  1 

Record  count 

U  1 

Print 


Begin  printing 
Eject  page  now 
View  report  on  screen 


Use  print  form  {<filename>} 

Save  settings  to  print  form 


>  Destination 

>  Control  of  printer 

>  Output  options 

>  Page  demensions 


Exit 


Save  changes  and  exit 
Abandon  changes  and  exit 


Seepage 
A- 1  5 


(J5W6-  THE 


Labels 


OJ 

<SI 


Layout 


Use  different  database  Tile  or  view 
Edit  description  of  label  design 
Save  this  label  design 


Dimensions 


Fields  Words 


>  Predefined  size  15/16  x  3  1/2  by  1 


Widfri  of  label  35 

Height  of  label  5 

tadertation  0 

Lines  between  label  1 

Spaces  between  label  columns  0 

Columns  of  labels  1 


1.  15/16  x  3  1/2  by  1 

2.  15/16x3  1/2  by  2 

3.  15/16x3  1/2  by  3 

4.  11/12x3  1/2  by  3  (Cheshire) 

5.  1  7/16  x  5  by  1 

6.  3  5/8x6  1/2  emvetope  (#7) 

7.  41/8x97/8  envelope  (#M) 

8.  Rolodex  (3x5)  \ 

9.  Rolodex  (2 1/4  x  4)  ^ 


>  Add  field 
Remove  field 

>  Modify  field 


Undo  deletion 

•  Style 

►  Display 

►  Position 
Modify  ruler 

Hide  ruler  NCVYES 

Enable  autofTHtfc  indent  YES/NO 


Add  line 
Remove  line 
Insert  page  break 
.  Write/read  text  file 


Seepage 

A- 1  2 


Seepage 
A- 1 4 


3> 

I 


Go  To 


Gototnenuntoer 

0 

Forward  search 

0 

Backward  search 

0 

Replace 

0 

Match  capitalization 

NO/YES 

Print 


Begin  printing 

Eject  page  now 

Generate  sample  label 

View  labels  on  screen 

Use  print  form 

(<filename>) 

Save  settings  to  print  form 

>  Destination 

>  Control  of  printer 

>  Output  options 

>  Page  dimensions 

r 

See  page  A- 15 


Exit 


Save  changes  and  exit 
Abandon  changes  and  exit 


A- 1  2 


Fields/Add  or  Modify  field 


1.  Fite  of  view 

Z  Calculated 

3.  Predefined 

4.  Summary 

< filename  or  view» 

CALCULATED 

PREDEFINED 

SUMMARY 

<  field  name> 

< field  names 

<creete> 

DATE 

T1VC 

PAGE  NO 

RECNO 

AVERAGE 

COUNT 

MAX 

MN 

SUM 

STD 

VAR 

1 

1 

1 

l 

r 

i  1 

Page  A-13 

J 


Page  A-13 
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u 


1.  Fite  or  View  Held 


2.  Calculated  field 


Field  name: 

Type: 

Length: 

Decimals: 

Template 

0 

>  Picture  functions 

(I 

>E<*t  options 

Ospteyas 

MARKE  FVW1NDOW 

>  Border  lines 

Supreos  repeated  values 

NCVYES 

H 


Name 

(1 

Description 

0 

Expression 

1) 

Template 

1) 

>  Picture  functions 

0 

Su press  repeated  values 

NOYES 

Hidden 

NOYES 

Name 

DATE/TTME  RECNOPAGENO 

Template 

U 

>  Picture  functions 

{) 

Su  press  repeated  values 

NOYES 

Name 

0 

Description 

n 

Operation 

Field  to  summarize  on 

0 

Reset  every 

0 

Template 

o 

>  Retire  tmctiore 

0 

Suppress  repeated  values 

NO /YES 

hidden 

NO/YES 

Only  numeric  and  character  date  types  haw  picture 
functions.  The  type  ol  functions  are  different 


t 

Edit  options 


Picture  functions  (numeric  Md) 


Picture  functions  (character  Held) 


E  citing  afo«ed 

YES/NO 

Psrrrit  edt  if 

u 

Message 

U 

Carry  forward 

YES/NO 

Default  value 

I) 

Smalest  allowed  value 

1) 

Largest  allowed  value 

II 

Accept  value  wrfien 

{) 

Unaccepted  message 

{) 

Alphabetic  characters  only 
Upper-case  conversion 
Literals  not  part  ol  date 

Scroti  within  dtepiay  width 
MuHpte  choice 

A  OFF/ON 

1  OFF/ON 

R  OFF/ON 

S  OFF/ON 

M  OFF/ON 

Trtin 

T  OFF/ON 

Ri^  atign 

J  OFF/ON 

Center  atign 

1  OFF/ON 

Horizontal  stretch 

H  OFF/ON 

Vertical  stretch 

V  OFF/ON 

Wrap  semicolons 

;  OFF/ON 

Positive  credits  followed  by  CR 
Negative  debits  followed  by  DB 
Use  ( )  around  negative  numbers 
Show  testing  zeros 

Barits  for  zero  values 

Financial  format 

Exponential  format 

C  OFF/ON 

X  OFF/ON 
(  OFF/ON 

L  OFF-ON 

Z  OFF/ON 
$  OFF/ON 
*  OFF/ON 

Trim 

T  OFF/ON 

Left  atign 

B  OFF/ON 

Center  align 

1  OFF/ON 

Horizontal  stioteh 

H  OFF/ON 

Vertical  stieteh 

V  OFF/ON 

J 
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;  Words 


Style  J 

Normal 

OFF/ON 

Bold 

OFF/ON 

Uhderfne 

OFF/ON 

talc 

OFF/ON 

Raised  (superscript) 

OFF/ON 

Lowered  (subscript) 

OFF/ON 

1.  -  - user  font-- 

2.  -  -  user  font  -  - 

3.  -  -  user  font  -  - 

4.  -  -  user  font  -  - 

5.  --user  font-- 

Display  (color  monitors) 


S  EXAMPLE 

Foreground 

Background 

Back 

Stock 

Blue 

Blue 

Green 

Green 

Cyan 

Cyan 

Red 

Red 

Magenta 

Magenta 

Brown 

Brown 

White 

Lt  Hue 

White 

Lt  Green 
LtCyan 

Lt  Red 

Lt  Magenta 
Yellow 

Brt  White 

BLINK  OFF/ON 

Words 


>  Display 

>  Position 
Modify  ruler 

Hderuter  NCVYES 

Enable  automatic  indent  YES/NO 


Add  line 
Remove  line 
Insert  page  break 
>  Writoftead  text  file 


Writortead  text  file 


Write  selection  to  file 
Read  toxt  from  file 


Position 


Display  (monochrome  monitors) 


totonsity  (Bold)  OFF/ON 
UndBrfne  OFF/ON 

Reverse  OFF/ON 

Hr*  OFF/ON 


Print 


-\ 

■t. 

if. 

cr 

r. 


Print  (Reports) 


Begin  printing 
Eject  page  now 
View  report  on  screen 


Use  pmt  form  (<filename>) 

Save  settings  to  print  form 


>  Destination 

>  Control  of  printer 

>  Output  options 

>  Page  demensions 


ir 


Destination 


Write  to 

PROTER/DOS  FILE 

Name  of  DOS  file 

{<rptname>.prt} 

Printer  model 

GENERIC/ASCII  TEXT 

Echo  to  screen 

NOYES 

Output  options 


Begnonpege  (1) 

End  after  page  (9999] 

First  page  number  {1} 
Number  of  copies  (1) 


53,767 


> 


Print  (Labels) 


Print  (Applications) 


Begin  printing 
Eject  page  now 
Generate  sample  label 
View  labels  on  screen 


Use  print  form  (<filename>) 

Save  settings  to  print  form 


>  Destination 

>  Control  of  printer 

>  Output  options 

>  Page  dimensions 


Begin  printing 

Eject  page  now 

Line  numbers 

NO/YES 

Use  print  form 

(<filename>} 

Save  settings  to  print  form 

_ 

>  Destination 

— 

>  Control  of  printer 

— 

>  Output  options 

— 

>  Page  dimensions 

Control  of  printer 


Tort  pith 

Quality  print 

PICA/ELFTE/CONDENSED/DEFAULT 

NO/YES/DEFAULT 

New  page 

BEFORE/BOTH/NONE/AFTER 

Wait  between  pages 

NO/YES 

Advance  page  using 

FORM  FEED/LINE^EEDS 

Starting  control  codes 

II  ^ 

Ending  control  codes 

(I 

Page  dimensions 


Length  of  page 

166} 

Wtdthof  page 

iW 

Offset  from  left 

Wl 

Spacing  of  lines 

SINGLE/ 

DOUBLE/TRIPLE 
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Appendix  B: 
Function  Key 
Table 


Key 

Result 

FI  Help 

F2  Data 

Display  on-screen  Help 

Switch  to  Browse  or  Edit  screen 

F3  Previous 

Move  to  previous  field  or  object  on  queries 
design  screen 

F4  Next 

Move  to  next  field 

F5  Field 

Adds  field  to  layout  surface  or  view  skeleton 

F6  Extend  Select 

Select  contiguous  data  or  fields 

F7  Move 

Move  selected  data 

F8  Copy 

F9  Zoom 

Copy  selected  data 

Enlarge/shrink  memo  fields,  condition  boxes, 
and  file  skeletons;  show/hide  files  in  DOS  utili¬ 
ties  directory  tree 

F10  Menus 

Access  menus  for  current  screen 

Shift -FI  Pick 

Display  list  of  items  available  for  current  fill-in 

Shift-F2  Design 

Display  the  design  screens  for  database  files,  que¬ 
ries,  reports,  forms,  labels,  or  applications 

Shift-F3  Find  Previous 

Locate  previous  occurrence  of  search  string 

Shift -F4  Find  Next 

Locate  next  occurrence  of  search  string 

Shift -F5  Find 

Find  specified  search  string 

Shift-F6  Replace 

Shift -F7  Size 

Replace  search  string  by  another  string 

Change  size  of  design  elements 

Shift-F8  Ditto 

Copy  data  from  corresponding  field  of  previous 

Shrft-F9  Quick  Report 

Shift-FlO  Macros 

record  into  current  field  JL  r, 

Print  a  Quick  Report  of  data  ® 

Access  m acros  menu  ^7  P.M, 

USING  THE  MENU  SYSTEM 
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Appendix  C: 
Cursor 
Navigation 
Keys 


Key 

Movement  or  action 

Work  surface 

- 

Right  one  position 

— 

Left  one  position 

i 

Down  one  row 

Next  field 

Edit 

T 

Up  one  row 

Previous  field 

Edit 

PgDn 

Display  next  screen 

Browse,  Edit 

Down  one  screen 

Word  wrap,  layout 

PgUp 

Display  previous  screen 

Up  one  screen 

Word  wrap,  layout 

End 

End  of  field 

Edit 

Last  field  in  record 

Browse 

Last  text/field  on  line 

Word  wrap,  layout 

Last  column  of  skeleton 

Queries 

Home 

Beginning  of  field 

Edit 

Beginning  of  record 

Browse 

Left  margin 

Layout 

Indent  (or  left  margin) 

Word  wrap 

First  column  of  skeleton 

Queries 

Backspace 

Delete  previous  character 

Tab 

Next  field 

Edit,  Browse 

Next  tab  stop 

Layout 

Tab 

Next  column 

Queries,  lists 

Insert  tab  character 

Word  wrap 

m  i7  p.w 
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Key 

Movement  or  action 

Work  surface 

Shift-Tab 

Previous  field 

Edit,  Browse 

Previous  tab  stop 

Layout 

Move  margin  left  one  tab 

Word  wrap 

Previous  column 

Queries,  lists 

— 

Next  field 

Browse,  Edit 

Form  new  paragraph 

Word  wrap  (with  Enable 
autoindent) 

Break  line,  move  to  new  one 

Layout  (if  Insert  is  on) 

Esc 

Leave,  abandoning  changes; 
cancel  extended  selection 

Del 

Delete  currently  selected  item 

Ins 

Toggle  insert/ typeover  modes 

Ctrl— 

Beginning  of  next  word  or  field 

Ctrl«- 

Beginning  of  previous  word  or 
field 

Ctrl-PgDn 

End  of  text 

Word  wrap 

Bottom  of  layout  surface 

Layout 

Current  field  in  last  record 

Browse,  Edit 

Ctrl -PgUp 

Beginning  of  text 

Word  wrap 

Top  of  layout  surface 

Layout 

Current  field  in  first  record 

Browse,  Edit 

Ctrl-Home 

Move  into  a  memo  field 

Memo  field 

Ctrl-End 

Save  work  and  leave 

Move  out  of  memo  field 

Memo  field 

Ctrl— 

Save  work  and  remain 

Design  screens 
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Work  Surfaces 


Layout  Organize  Append  Go  To  Exit 

Bytes  remaining'  3985 
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Field  None 

Field  Type 
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Index 

ZB 

S 

15 

15 

a 

1 

TYflS  op  fi£LV 
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Copyright  ®  Ashton-Tate  Corporation  1988 
As  an  unpublished  work.  All  Rights  Reserved. 

Use  of  the  software  contained  in  this  package  has  been  provided  under 
a  Software  License  Agreement.  Please  read  it  thoroughly.  In  summary, 
you  may  not  make  copies  of  the  software  except  as  specifically  permit¬ 
ted  under  the  Software  License  Agreement.  You  may  use  the  software 
only  on  a  single  terminal  or  a  single  workstation  of  a  computer  (or  its 
replacement):  accordingly,  you  must  license  a  separate  copy  for  each 
terminal  or  workstation  where  you  want  to  use  the  software  or  use  the 
multi-user  version  on  the  permitted  number  of  workstations  as  set  forth 
in  the  multi-user  license  agreement. 

Note:  Unauthorized  use  of  the  software  or  of  the  related  materials  can 
result  in  civil  damages  and  criminal  penalties. 

The  software  and  related  materials  in  this  package  are  licensed  with  a 
Limited  90-Day  Warranty.  Other  than  the  limited  warranties  that  are 
expressly  stated  therein,  Ashton-Tate  makes  no  other  warranty, 
express  or  implied,  to  you  or  any  other  person  or  entity.  We  will  not 
be  liable  for  incidental,  consequental  or  other  similar  damages.  In 
no  event  will  our  liability  for  any  damages  ever  exceed  the  price 
paid  for  the  license  to  use  the  software,  regardless  of  any  form  of 
the  claim.  You  may  have  other  rights  which  vary  from  state  to  state. 

Ashton-Tate  and  the  Ashton-Tate  logo,  dBASE,  dBASE  II,  and  dBASE  III 
are  registered  tr  idemarks  of  Ashton-Tate  Corporation.  dBASE  III  PLUS, 
dBASE  IV,  Framework  II,  and  RapidFile  are  trademarks  of  Ashton-Tate 
Corporation. 

CHART-MASTER  is  a  registered  trademark  of  Ashton-Tate  Corporation 
and  is  used  under  license  from  Chartmasters,  Inc.  Chartmasters  is  a 
registered  trademark  of  Chartmasters,  Inc. 

GENERAL  NOTICE:  Other  product  names  used  herein  are  for  identifi¬ 
cation  purposes  only  and  may  be  trademarks  of  their  respective 
companies. 

For  use  in  the  United  States  and  Canada.  Not  for  export. 
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This  manual  shows  how  the  dBASE  IV  Applications  Generator  can  help  solve 
data  management  problems  for  you,  your  company,  or  your  clients.  It 
explains  what  an  application  is  and  how  to  create  one  with  the  Applications 
Generator.  You’ll  find  it  useful  whether  you’re  new  to  application  develop¬ 
ment  or  an  experienced  programmer. 

The  Applications  Generator  is  an  easy-to-use  tool  that  frees  you  from  pro¬ 
gramming  while  providing  you  the  flexibility  to  create  customized  applica¬ 
tions.  It  shortens  development  time  by  automatically  generating  dBASE  pro¬ 
gram  code  you’d  ordinarily  have  to  write.  The  ability  to  add  dBASE  code  to 
your  applications  means  you  also  have  access  to  all  the  power  of  the  dBASE 
language  itself. 

For  those  new  to  application  development,  Using  the  dBASE  IV  Applications 
Generator  gives  you  the  basics  of  application  design,  as  well  as  instructions 
for  using  the  Applications  Generator  to  create  applications. 

For  experienced  application  developers,  Using  the  dBASE  IV  Applications 
Generator  serves  as  a  reference  tool  as  you  work.  Once  you’ve  become 
skilled  with  the  Applications  Generator,  you  have  further  options.  If  you 
purchased  the  dBASE  IV  Developer's  Edition,  you  can  refer  to  the  Template 
Language  manual  for  information  on  customizing  the  Applications  Genera¬ 
tor.  If  not,  you  can  purchase  it  by  sending  the  order  card  enclosed  in  this 
package  to  Ashton-Tate. 

This  book  is  divided  into  two  tab  sections.  The  first,  “The  Basics,’’  explains 
the  concept  of  applications  and  how  to  use  the  Applications  Generator  to 
develop  a  sample  application. 

The  second  tab  section,  “Reference,”  contains  the  information  you’ll  need 
as  you  build  your  own  applications  with  the  Applications  Generator.  It 
describes  the  Applications  Generator  mend  bar  and  options  in  detail.  An 
overall  picture  of  the  menu  system  appears  in  Appendix  B,  “Menu  Trees.” 

A  glossary  of  terms  related  to  the  Applications  Generator  appears  in 
Appendix  A.  Explanations  of  error  messages  can  be  found  in  the  Language 
Reference  manual. 


Using  i 
dBASE 


USING  THE  dBASE  IV  APPLICATIONS  GENERATOR 


1-1 


JOBNrAME:  No  Job  Name  PAGE:  2  SESS:  3  UUiPUl:  lue  Aug  A  iu:o/:jo  ivo» 
CLS:  manhat  GRP:  manhat  JOB:  manappgen  DIV:  agintro 


Where  to  Begin 

Before  using  the  Applications  Generator,  you  should  already  know  how  to 
create  and  use  database  files,  indexes,  reports,  forms,  and  labels.  You  should 
also  be  familiar  with  the  Control  Center  and  dot  prompt.  If  you  need  a 
refresher,  see  Learning  dBASE  IV  and  Introduction  to  the  Dot  Prompt  (if 
you  purchased  dBASE  IV)  and  Using  the  Menu  System  (if  you  purchased  the 
dBASE  IV  Developer’s  Edition). 

New  application  developers  should  follow  these  steps: 

1 .  Read  and  follow  the  instructions  in  Chapters  1  through  3  in  order. 

2.  Use  information  in  the  “Reference’’  tab  section  when  building  your  own 
applications. 

Experienced  dBASE  developers  can  save  time  by  following  these  steps: 

1.  Read  “What's  the  Applications  Generator?’’  in  Chapter  1. 

2.  Get  started  by  following  the  instructions  in  Chapter  2,  “Starting  and 
Leaving  the  Applications  Generator.” 

3.  Refer  to  “Using  the  Sample  Application  Design’’  in  Chapter  3  and  the 
information  in  the  “Reference”  tab  section  as  you  build  your  own 
applications. 


Conventions  in  This  Manual 

Understanding  the  information  in  this  manual  is  much  easier  when  you 

know  the  following  conventions: 

■  The  word  press  is  used  for  keys  you  press;  the  word  type  or  enter  is  used 
for  information  you  must  type  in.  Function  keys  (in  the  dedicated  keypad 
on  your  keyboard)  are  shown  with  their  assigned  functions,  as  in  the  fol¬ 
lowing  example:  FI  Help. 

■  Commands  or  entries  that  you  type  are  in  a  different  typestyle  and  in 
color. 

■  Instructions  to  press  the  RETURN  or  ENTER  key  are  represented  by  the 

symbol. 

■  Menu  names  and  items,  messages  you  receive  from  the  program,  and 
other  on-screen  references  are  in  bold  type. 

■  Variable  information  that  you  provide  appears  between  left  and  right 
angle  brackets.  For  example,  <  INI  >  indicates  that  you  type  in  your 
own  initials.  (Certain  on-screen  prompts  may  also  appear  between  angle 
brackets,  such  as  the  <  create  >  marker.) 
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This  chapter  focuses  on  the  background  information  you  need  to  effectively 
use  the  Applications  Generator.  It  defines  the  term  application  and  explains 
how  the  Applications  Generator  relates  to  other  product  components.  It  then 
describes  the  design  issues  involved  in  developing  an  application. 


What’s  an  Application? 

The  terms  application  and  program  are  often  used  interchangeably.  A  pro¬ 
gram  is  a  set  of  commands,  written  in  a  programming  language  such  as 
dBASE,  that  does  some  computing  task.  You  may  have  already  used  a  few 
dBASE  commands  from  the  dot  prompt  (for  example,  typing  LIST  to  show 
the  contents  of  a  database  file). 

The  following  program  shows  some  of  the  commands  you  may  have  already 
used.  It  references  a  database  file,  Money. dbf,  which  contains  information 
about  customers  who  owe  money,  and  prints  a  list  of  customers  who  need  to 
be  reminded  to  pay  their  accounts. 


USE  Money  INDEX  Last 
LIST  FOR  Owing  TO  PRINTER 
CLEAR 

LIST  FOR  Owing  .AND.  Pastdue  TO  PRINTER 
CLEAR 

SUM  Amount_due  FOR  Owing  TO  PRINTER 

SUM  Amount_due  FOR  Owing  .AND.  Pastdue  TO  PRINTER 

REPORT  FORM  Reminder  FOR  Owing  PLAIN  TO  PRINTER 

REPORT  FORM  Warning  FOR  Owing  .AND.  Pastdue  PLAIN  TO  PRINTER 


Rather  than  typing  these  commands  every  time  you  wanted  to  print  these 
reports,  you  could  put  the  commands  in  a  program  file  named,  for  example, 
Overdue. prg.  To  run  the  program,  you’d  enter  DO  Overdue  at  the  dot  prompt 
or  choose  it  from  the  Control  Center  Applications  panel. 

An  application  is  a  set  of  programs,  such  as  Overdue. prg,  that  does  various 
related  tasks.  Broadly  speaking,  dBASE  IV  is  an  application.  It’s  a  large  appli¬ 
cation  that  allows  you  to  do  a  multitude  of  tasks  with  databases,  including 
building  other  database  applications. 
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What’s  the  Applications  Generator? 

The  dBASE  IV  Applications  Generator  is  a  component  of  dBASE  IV  that 
helps  you  build  applications  of  your  own.  The  Applications  Generator  creates 
the  program  code  needed  to  run  an  application,  which  means  that  you  can 
build  applications  without  writing  programs.  For  example,  using  the  Applica¬ 
tions  Generator,  you  could  create  a  personal  application  that  would  store 
names  and  addresses  of  friends,  remind  you  of  important  dates,  balance  your 
checkbook,  and  keep  an  inyentorv  of  your  belongings  for  insurance  purposes. 

You  could  also  create  a  medical  office  application  to  handle  medical  and 
billing  records,  inventory,  and  tax  records.  This  application  might  require 
on-screen  forms  for  adding  information  and  printing  invoices  and  financial 
reports.  Whether  simple  or  complex,  your  application  can  be  built  easily  and 
quickly  with  the  Applications  Generator. 

In  this  manual,  the  term  application  has  an  additional  meaning.  An  applica¬ 
tion  built  with  the  Applications  Generator  refers  to  a  set  of  objects  (database, 
index,  and  query  files,  reports,  forms,  menus,  lists,  and  so  forth)  that  work 
together.  You  create  some  of  the  objects  through  the  Control  Center  or  dot 
prompt,  such  as  database  files  and  reports.  Others,  such  as  menus  and  lists, 
you  create  with  the  Applications  Generator.  The  Applications  Generator  then 
generates  the  dBASE  code  needed  to  tie  the  objects  together  as  an  applica¬ 
tion.  Figure  1-1  illustrates  the  relationship  of  objects  in  an  application  built 
with  the  Applications  Generator. 


Created  through 
Control  Center 
or  dot  prompt 


Created  with 
the  Applications 
Generator 


Figure  1-1  Objects  in  an  application 
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Designing  an  Application 

If  you’re  new  to  application  development,  you  may  want  to  learn  some  basic 
application  design  principles  before  using  the  Applications  Generator.  If  you 
do,  read  through  the  rest  of  this  chapter.  If  you’re  eager  to  get  started,  how¬ 
ever,  skip  to  Chapter  2,  "Starting  and  Leaving  the  Applications  Generator." 
Then,  when  you’re  ready  to  design  your  own  applications,  come  back  to  this 
chapter. 

Creating  an  application  that  serves  the  needs  of  the  user  takes  some  plan¬ 
ning.  The  following  discussion  introduces  principles  that  will  help  you 
plan  effectively,  but  it’s  not  intended  to  be  a  comprehensive  treatment  of 
the  subject. 


Analyzing  a  Work  System 

You  design  an  application  in  response  to  the  requirements  of  a  work  system 
that  may  or  may  not  already  be  computerized.  For  example,  a  video  rental 
store  may  have  its  customers  listed  on  computer  but  not  its  inventory,  or  the 
employees  may  keep  manual  records  of  customers  and  inventory.  So,  the 
first  step  in  designing  an  application  is  assessing  the  work  system:  what  is 
needed  and  by  whom?  If  the  application  is  for  someone  other  than  yourself, 
you  should  involve  them  in  the  analysis.  You  can  do  that  by  asking  the  fol¬ 
lowing  questions: 

■  What  reports  and  mailings  are  needed? 

■  What  forms  are  used  in  record  keeping? 

■  What  do  they  wish  their  current  system  could  do? 

■  What  is  the  expertise  level  of  the  users  of  the  proposed  application? 

■  What  plans  for  expansion  should  be  built  into  the  application? 
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Once  you  have  this  information,  you  can  follow  the  steps  shown  in  Figure 
1-2  to  prepare  an  application  design  plan. 


Describe  output 
(reports  and  labels) 


1- 

Describe  input  forms 


I 

Specify  the  database, 
index,  and  query  files 


Describe  how  user  will 
modify  database  files 


Describe  menus,  lists, 
and  batch  processes 


1 

Describe  the  application 
operational  flow  (what 
the  users  see  and  do) 


Figure  1  -2  Planning  an  application 


You’ll  see  a  sample  application  design  in  Chapter  3,  “A  Sample  Application.” 

If  you  plan  your  application  before  using  the  Applications  Generator,  you 
can  greatly  reduce  the  time  spent  building  the  application.  Planning  will  also 
help  you  maintain  and  update  your  application  later.  While  this  approach  is 
preferred,  it's  not  the  only  method.  Sometimes  developers  design  as  they  go. 
Fortunately,  you  can  easily  modify  the  objects  in  your  application,  so  you’re 
not  bound  by  one  design  approach. 


Designing  Your  Files 

The  next  step  is  to  design  the  objects  of  the  application,  as  shown  in  Figure 
1-1.  Because  the  design  of  your  database  files  will  affect  the  entire  applica¬ 
tion,  it's  important  to  understand  some  database  file  design  principles. 

Designing  Database  Files 

The  structures  of  your  database  files  are  important.  You  must  decide  the 
name  of  the  fields,  the  type  of  data  they’ll  contain,  and  how  long  each  field 
should  be.  The  following  figure  shows  a  database  file  structure  created  in 
dBASE. 
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12=  29:  59  p* 


Figure  1  -3  Database  file  structure 


The  rules  of  good  database  file  design  are: 

1 .  Avoid  storing  redundant  data. 

The  following  example  illustrates  this  rule. 


DEPARTMENT  DATABASE  FILE 


department 

code 

director 

name 

employee 

Figure  1-4  Poor  database  file  design 

In  Figure  1-4,  the  director  name  must  be  stored  for  every  employee 
record.  A  better  design  would  be  to  split  this  database  file  into  two  files, 
as  shown  in  Figure  1-5. 


DEPARTMENT  DATABASE  FI  LE  EMPLOYEE  DATABASE  FI  LE 


department 

director  | 

department 

employee 

code 

name 

code 

name 

a 

Figure  1  -5  Correct  database  file  design 

The  design  in  Figure  1-5  saves  disk  space,  an  important  consideration 
when  your  database  files  are  large. 
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2.  Dependent  fields  in  a  record  must  depend  on  the  key,  not  on  each  other. 

In  the  example  shown  in  Figure  1-6,  the  completion  date  depends  on  the 
task  number,  not  on  the  key  field  (employee  number). 


EMPLOYEE-TASK  DATABASE  FILE 


r  1 

I 

~ l 

employee 

empfby** 

task 

completion  I 

number 

nam* 

number 

date 

T 


Figure  1-6  Undesirable  dependence 

This  dependence  would  result  in  some  problems.  For  example,  if  you 
were  to  delete  the  employee  record,  the  task  number  and  completion 
date  would  also  be  deleted.  A  better  file  design  is  shown  in  Figure  1-7. 


4 

employe*  number 


K 


EMPLOYEE  DATABASE  FILE 

z 


employee  name 


K 


task  number 


completion  date 


K 


task  number 


TASK  DATABASE  FILE 


h 

r 


RELATED 

FIELD 


Figure  1  7  Correct  dependence 


When  you  link  two  database  files,  you  create  a  relationship  between  them. 
Using  the  design  in  Figure  1-7,  you  could  create  reports  that  include 
employee  number,  name,  task  number,  and  completion  date,  without  the 
problems  of  the  previous  design  that  stored  all  data  in  one  file. 

Anticipate  future  enhancements  to  your  application.  Keep  in  mind  what 
additional  fields  might  be  needed  and  whether  they,  or  existing  fields,  might 
be  key  fields  for  a  new  database  file.  You  may  wish  to  design  these  database 
files  at  the  outset  and  create  relationships  between  them. 


NOTE 

In  dBASE,  you  can  relate  database  files  by  using  a  view.  For  more 
information  on  relating  database  files,  refer  to  Using  the  Menu  System 
or  the  SET  RELATION  and  CREATE  VIEW  commands  in  Language 
Reference. 
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Designing  Index  Files 

All  database  applications  should  allow  users  to  find  information  quickly.  An 
application  that  searches  a  large  unindexed  database  file  can  slow  users 
down  unnecessarily.  A  better  design  includes  index  files  that  order  the  data¬ 
base  file.  This  greatly  reduces  the  search  time. 

Suppose  you  want  your  application  to  allow  users  to  quickly  find  a  record 
about  a  particular  customer.  You'd  design  and  create  an  index-file  in  which 
certain  information,  such  as  customer  last  names,  is  stored  in  alphabetical 
order.  Associated  with  each  last  name  in  the  index  file  is  a  key  field  (for 
example,  employee  number)  that  indicates  where  the  rest  of  the  record  can 
be  found  in  a  customer  database  file.  In  the  Applications  Generator,  you  can 
assign  .mdx  files  and  up  to  ten  .ndx  files  to  each  database  file  used  in  your 
application. 


Refining  the  User  Interface 

A  user  interface  is  what  the  user  sees  on  the  screen  —  the  menus  and  forms 
through  which  the  user  views,  adds,  or  changes  data.  A  simple,  well-designed 
user  interface  makes  the  user's  job  easier,  even  enjoyable. 

Once  you  know  the  menus,  reports,  and  forms  you’ll  need,  you  can  spend 
some  time  refining  them.  You  can  create  the  forms  and  reports  through  the 
Control  Center  or  dot  prompt  and  customize  them  to  your  tastes.  Then,  with 
the  Applications  Generator,  you  can  easily  generate  the  menus  for  your 
application. 

Because  you  have  many  options  for  customizing,  you  should  consider  some 
of  the  issues  involved  in  creating  the  user  interfaces.  These  include: 

■  Where  information  should  be  placed  on  the  screen  for  maximum 
effectiveness 

■  Where  to  present  error  messages 

■  How  much  information  should  be  on  a  typical  screen 

■  How  to  format  a  menu 

■  When  to  use  highlighting,  color,  and  sound 

■  What  to  consider  when  assigning  function  keys 


The  following  guidelines  address  these  issues.  Of  course,  there  are  excep¬ 
tions  to  every  rule,  so  let  your  good  judgment  be  your  guide. 

1.  Put  important  information  in  the  center  of  the  screen.  For  a  standard 
80-column  by  24-line  screen,  try  to  place  the  main  message,  whether  text 
or  a  menu,  between  columns  10  and  70  and  rows  6  and  19. 

People  tend  to  view  a  screen  as  organized  into  center,  bottom,  top.  right, 
and  left  areas.  Because  a  viewer’s  eyes  go  first  to  the  center  of  the 
screen,  that’s  where  important  information  should  appear. 

2.  Put  less  important  information  off  the  center  of  the  screen. 
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3.  Display  the  same  type  of  information  in  the  same  place. 

Your  interface  will  be  easier  to  learn  and  understand  if  you  use  a  stan¬ 
dard  system.  Error  messages  are  an  example  of  information  that  should 
be  placed  off  center  and  in  the  same  location  every  time. 

4.  Use  blank  space  to  avoid  screen  clutter. 

Use  blank  spaces  to  separate  columns  and  to  indent  information. 

5.  Format  stand-alone,  vertical  menus  carefully. 

Guidelines  include: 

a.  Start  each  menu  with  a  heading. 

b.  Format  the  menu  with  an  uneven  right  margin,  rather  than  present 
the  menu  in  block  style.  (Aligned  right  margins  are  harder  to  read.) 

c.  Limit  the  number  of  menu  items  to  nine  or  fewer. 

6.  Emphasize  areas  of  the  screen  with  decorative  borders,  highlighting,  and 
underlining. 

7.  Limit  use  of  color  in  the  standard  interface  (menus  and  window  frames, 
and  dialog  boxes). 

Keep  in  mind  that  many  users  don’t  have  color  monitors  or  are  color¬ 
blind.  Color  borders  appear  fuzzy  to  some  people. 

8.  Use  sound  to  make  users  aware  of  the  state  of  the  application  or  to  get 
their  attention. 

If  a  user  is  likely  to  turn  away  from  the  computer  while  the  application 
is  doing  a  time-consuming  task,  for  example,  use  an  audio  and  visual 
alert  to  indicate  the  end  of  the  task. 

9.  Assign  function  keys  consistent  with  standard  assignments. 

You  should  consider  matching  function  key  assignments  as  closely  as 
possible  to  other  applications  similar  to  yours.  For  example,  FI  is  a  key 
that  many  applications  use  to  call  Help. 


also  wish  to  refer  to  books  devoted  to  interface  design. 


NOTE 

A  more  detailed  discussion  on  information  placement  and  menu 
design  is  in  Ashton-Tate's  Advanced  Programmers’  Guide.  You  ma\ 


The  time  invested  in  design  is  time  well  spent.  You’ll  find  the  other  tasks  of 
application  building  much  less  difficult  if  you  think  through  your  design. 
Later  in  this  tab  section,  you’ll  have  the  opportunity  to  use  these  design  prin¬ 
ciples  in  a  sample  application.  In  the  next  chapter,  you’ll  learn  more  about 
the  Applications  Generator  —  how  to  use  it  and  what  it  can  do  for  you. 
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Starting  and 
Leaving  the 
Applications 
Generator 


The  previous  chapter  introduced  you  to  the  issues  involved  in  application 
design  and  how  the  Applications  Generator  can  simplify  the  process  of  build¬ 
ing  an  application.  This  chapter  tells  you  how  to  quickly  enter  the  Applica¬ 
tions  Generator  and  describes  the  Applications  Generator  desktop.  You’ll 
then  see  how  to  leave  the  Applications  Generator. 


Understanding  the  Applications  Generator 

The  Applications  Generator  is  an  easy-to-use  tool  for  building  both  simple 
and  complex  applications.  The  job  of  building  applications  is  made  easier 
by  the  Applications  Generator’s  "what  you  see  is  what  you  get"  (WYSIWYG) 
environment.  Once  you’ve  decided  what  menus  and  other  objects  your  appli¬ 
cation  will  feature,  you  can  create  and  position  them  where  you  want  them 
to  appear  when  the  application  is  run. 

While  you  can  build  many  fully  functional  applications  without  writing  pro¬ 
grams,  the  Applications  Generator  also  gives  you  the  ability  to  add  dBASE 
code  to  your  applications.  This  access  to  the  powerful  dBASE  programming 
language  gives  you  flexibility  to  design  an  application  as  complex  as  you,  or 
your  users,  want  it. 

The  ability  to  create  objects  (database  and  query  files,  reports,  forms,  menus, 
lists,  and  batch  processes)  in  any  order  you  wish  is  another  benefit  of  the 
Applications  Generator.  If  you  change  vour  design  while  you’re  building 
the  application,  you  can  easily  return  to  other  design  screens  to  create  these 
objects.  (The  various  ways  you  can  build  an  application  are  explained  in  the 
"Applications  Generator  and  Other  Product  Components"  section.) 

You  can  also  save  time  by  creating  generic  objects  that  can  be  easily  custom¬ 
ized  for  particular  users.  For  example,  you  might  create  a  set  of  objects  for  a 
medical  office  application.  Then,  when  you  need  to  develop  an  application 
for  a  specific  physician,  all  you  have  to  do  is  modify  the  application  you’ve 
already  created. 


What  You  Need  to  Get  Started 

If  you're  using  dBASE  IV,  you  already  have  the  software  and  hardware 
you  need  to  use  the  Applications  Generator.  The  requirements  for  using 
dBASE  IV  and  the  Applications  Generator  are  listed  in  Getting  Started. 
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NOTE 

You  can  also  use  the  requirements  listed  in  Getting  Started  to  config¬ 
ure  systems  for  the  users  of  your  application. 


Applications  Generator  and  Other  Product 
Components 

The  following  illustration  shows  the  Applications  Generator’s  relationship  to 
other  dBASE  components.  Some  of  the  components  are  only  described  in 
the  manuals  included  with  the  dBASE  IV  Developer’s  Edition.  (To  order  the 
dBASE  IV  Developer’s  Edition,  use  the  card  enclosed  in  your  dBASE  IV 
package.) 


Create  Database,  Query, 
and  Index  Files,  Reports, 
Forms,  and  Labels 


Use  Template 
Language  to  add 
^templates  or 
change  how 
the  Applications 
Generator  works 


Run 

Application 
DO  <appname> 


Optional:  For 
professional  developers 
to  distribute  application. 
Users  can  run  but  not 
change  application 


RunTime 

BUILD 


The  Applications 
Generator  produces 
these  files  : 

1  <appname>.prg  file  and 
1  <mainmenu>  .prg  file 


Enter  the 

Applications 

Generator 


(dot  pri 

»mpt) 

Enter  the 

Applications 

Generator 

Applications  Generator 

MENU.GEN 

DOCUMENT  GEN 
QUICKAPP.GEN 

SQL 

Control  Center 

□  □□□ 


Figure  2-1  Relationship  to  product  components 
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Figure  2-1  shows  how  the  Control  Center  and  dot  prompt  components  of 
dBASE  IV  are  related  to  the  Applications  Generator.  You  create  some  objects 
for  vour  application  through  the  Control  Center  or  dot  prompt  and  others 
with  the  Applications  Generator.  You  can  create  the  objects  in  any  order  you 
wish.  The  possible  creation  sequences  follow: 

1.  Create  all  the  non-Applications  Generator  objects,  such  as  database  and 
query  files,  forms,  and  reports.  Then,  enter  the  Applications  Generator 
and  create  the  menus;  lists,  and  batch  processes  and  generate  the  code 
for  the  application. 

2.  Enter  the  Applications  Generator  first,  and  then  return  to  the  file,  query, 
form,  report,  and  label  design  screens  as  needed  to  create  these  objects. 
In  other  words,  you  move  among  components  in  one  work  session,  cre¬ 
ating  objects  as  you  go.  You  finish  by  generating  the  code  in  the  Applica¬ 
tions  Generator,  and  running  the  application  from  the  dot  prompt  or 
Control  Center. 

For  example,  when  specifying  a  menu  item  to  print  a  report,  you’re 
asked  to  enter  the  name  of  the  report.  To  leave  the  Applications  Gen¬ 
erator  and  create  the  report,  you  would  press  Shift-FI  Pick  and  choose 
<  create  >  .  After  creating  the  report,  you’d  return  to  the  Applications 
Generator  by  choosing  Save  changes  and  exit  from  the  Exit  menu. 

3.  Build  menus,  lists,  and  batch  processes,  and  identify  non-Applications 
Generator  objects,  but  don’t  create  them  immediately.  Then  generate 
the  code  for  your  application.  Returning  to  the  dot  prompt  or  Control 
Center,  you  then  create  all  the  other  objects  and  run  the  application. 
Note  that  you  can  generate  code  for  your  application  without  creating 
the  non-Applications  Generator  objects,  such  as  database  files,  reports, 
and  forms.  However,  you  must  create  these  objects  to  actually  run  your 
application. 


NOTE 

This  manual  emphasizes  the  first  sequence  because  it  requires 
fewer  moves  between  the  components.  When  creating  your  own 
applications,  you'll  probably  use  a  combination  of  these  three 
methods. 


Starting  the  Applications  Generator 

This  section  explains  how  to  quickly  enter  the  Applications  Generator  so  that 
you  can  become  familiar  with  the  Applications  Generator  desktop.  (In  the 
next  chapter,  you’ll  build  a  complete  sample  application.)  Because  the  Appli¬ 
cations  Generator  is  a  component  of  dBASE  IV,  you  can  start  from  either  the 
dot  prompt  or  the  Control  Center.  If  you’re  relatively  new  to  dBASE.  you 
should  probably  start  at  the  Control  Center.  Skip  the  next  heading  and  follow 
the  instructions  under  "Starting  from  the  Control  Center." 
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Starting  from  the  Dot  Prompt 

To  create  a  new  application,  type: 
create  application  <  application  name  > 
and  press  «-J. 

You'll  see  the  dialog  box  shown  in  Figure  2-3.  Once  you  fill  it  out,  as 
explained  under  "Starting  from  the  Control  Center,"  you’ll  see  the 
Applications  Generator  desktop  shown  in  Figure  2-4. 

For  information  about  choosing  an  existing  application,  see  "Modifying 
Your  Application"  in  Chapter  3. 


Starting  from  the  Control  Center 

You  can  also  create  an  application  from  the  Control  Center.  If  this  is  your 
first  time  using  the  Applications  Generator,  use  the  Control  Center  method 
to  create  a  new  application. 

To  create  an  application,  follow  these  steps: 

1.  From  the  Control  Center,  move  the  cursor  to  the  Applications  panel. 
Your  screen  will  look  like  Figure  2-2. 


Tools  Exit 

dBASE  IU  CONTROL  CENTER 

CATALOG:  C:\DBASE\SAMPLES\SAMPLES.CAT 
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LOCATOR 

NANESORY 

"ADDCODES 

ADDB00K  1 

CONTACTS 

OBJECTS 

PHONELOG 

ALLNAMES 

CARDREC 

I NU ENTRY 
REGIONAL 

CARDONLY 

INUITES 

MAILALL 

NAMETAGS 

AREACODE 
■US I NESS 
CHRTHSTR 
PERSONAL 

File'  flHHL— 

Description'  v 

Help- FI  Use:  «-l  Data'  FI 

l  Design: Shi ft-FZ  Quick  Report' Shi ft-FS  Menus'  FIB 

Figure  2-2  Control  Center 


2.  With  the  highlight  on  the  <  create  >  marker,  press  «-*.  Then  choose 
Applications  Generator  from  the  dialog  box  that  displays  by  pressing  -► 
and  then  pressing  «-J. 

You'll  see  the  dialog  box  illustrated  in  Figure  2-3. 
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Figure  2-3  New  application  definition 

3.  At  the  Application  name  field,  type  testapp  and  press  4-*. 

An  entry  in  this  field  is  required.  Later,  when  building  your  own  applica¬ 
tions,  the  application  name  must  be  unique  within  the  directory,  and  it 
must  be  one  that  dBASE  will  recognize.  Try  to  give  it  a  name  that  you  or 
your  users  can  easily  identify  from  a  list  of  application  files.  The  Applica¬ 
tions  Generator  assigns  the  .app  extension  to  the  name  entered  here. 
You’ll  see  the  name  and  extension  in  your  disk  directory. 

4.  At  the  Description  field,  type  This  is  a  test  application  and  press  4-4 

Later,  when  building  your  own  applications,  this  description  will  appear 
in  the  code  and  documentation  created  by  the  Applications  Generator. 

An  entry  in  this  field  is  not  required. 

5.  At  the  Main  menu  type  field,  press  the  Spacebar  to  see  the  types  of 
objects  that  can  start  your  application.  Select  POP-UP,  and  press  4-J  to 
move  to  the  next  field. 

The  default  object  type  is  BAR,  a  horizontal  bar  menu  (such  as  the  menu 
at  the  top  of  the  screen).  A  pop-up,  or  vertical,  menu  (POP-UP)  and  batch 
process  (BATCH)  can  also  serve  as  a  main  menu.  (A  batch  process  can  do 
several  tasks  behind  the  scenes,  one  of  which  might  be  opening  a  menu.) 

6.  Skip  the  Main  menu  name  field  by  pressing  4-4 

Later,  when  building  your  own  applications,  you  can  enter  the  name  of 
the  menu  or  batch  process  that  you  want  to  start  your  application.  If 
you  haven’t  yet  created  it,  type  in  a  name  that  dBASE  can  recognize.  If 
it  has  been  created,  press  Shift-FI  Pick,  and  choose  it  from  the  list  that 
displays. 

The  Applications  Generator  assigns  the  three-character  extension  .bar  if 
the  starting  menu  is  a  horizontal  bar  menu,  .pop  if  it's  a  pop-up  menu,  or 
.bch  if  it’s  a  batch  process.  You'll  see  this  name  and  extension  in  your 
disk  directory  later. 
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An  entry  in  this  field  is  not  required  at  this  time.  You  can  specify  the 
main  menu  at  any  time  while  building  the  application  or  when  you  gen¬ 
erate  code. 

7.  At  the  Database/vlew  field,  type  testdbf  and  press  ♦-J. 

This  is  the  name  of  the  database  file  or  view  associated  with  this  applica¬ 
tion.  When  building  your  own  applications,  you  can  type  in  the  name  or 
press  Shift-FI  Pick  to  choose  one  from  the  current  catalog  or  directory. 

This  is  the  database  file  or  view  that  you  want  to  serve  as  the  default  for 
the  application.  Later,  you  can  override  the  default  by  assigning  a  differ¬ 
ent  database  file  or  view  for  specific  objects  or  items.  For  example,  each 
menu  in  your  application  can  use  a  different  database  file.  An  entry  in 
this  field  is  required,  although  you  can  name  a  database  file  or  view  that 
hasn’t  yet  been  created. 

8.  Skip  the  Set  INDEX  to  field  by  pressing  «-*. 

This  field  accepts  the  name  of  the  index  or  indexes  associated  with  this 
application,  if  any.  Later,  if  you  want  to  use  index  files  (.mdx  or  .ndx) 
in  your  own  application,  you  can  enter  the  names  here,  separated  by 
commas.  You  can  also  choose  one  or  more  index  files  from  a  list  that 
appears  when  you  press  Shift-FI  Pick. 

9.  Leave  the  ORDER  field  blank. 

This  field  accepts  the  index  order  number  or  name  of  a  new  controlling 
index,  if  any.  You  can  type  in  the  order  number  or  name. 

10.  To  finish  defining  the  application  object,  press  Ctfi-End. 

Now  you  can  see  the  entire  Applications  Generator  desktop  with  the  applica¬ 
tion  object  on  it. 
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The  application  object  always  stays  on  the  desktop.  You  can  resize  and  move 
it  (using  keys  described  later)  to  unclutter  the  work  surface,  the  area  of  the 
desktop  on  which  it  appears.  If  you  wish,  the  application  object  can  serve  as 
the  first  screen  your  users  see,  and  you  can  change  the  information  that 
appears  in  it.  For  example,  you  can  include  a  greeting  to  your  users,  such  as 
Welcome  to  this  Application,  or  a  title,  such  as  The  Address  Manager,  in 
the  application  object. 

When  used  as  the  initial  screen  of  an  application,  this  object  is  called  a  sign- 
on  banner.  You’ll  leam  jiow  to  specify  that  the  application  object  be  used  as 
a  sign-on  banner  in  the  next  chapter. 


NOTE 

In  the  Applications  Generator,  you  can  only  work  on  one  application 
at  a  time.  To  work  on  an  application  other  than  the  current  one,  you 
have  two  choices.  You  can  save  all  objects,  return  to  the  Control 
Center  or  dot  prompt,  and  enter  the  Applications  Generator  again, 
where  you  can  choose  to  create  or  modify  another  application.  Or, 
you  can  rename  the  current  application,  and  modify  and  save  it. 

For  more  information,  see  “About  Generic  Applications''  in  the 
“ Reference "  tab  section. 


The  number  of  other  objects  (for  example,  menu  objects)  that  the  work  sur¬ 
face  can  hold  depends  on  the  amount  of  memory  used  by  dBASE  IV  and  the 
Applications  Generator  at  the  time.  If  you  try  to  create  more  objects  than  the 
Applications  Generator  can  handle,  a  message  appears  that  tells  you  to  put 
away  some  objects  first.  You  can  always  bring  these  objects  back  to  the  work 
surface  if  you  need  to  modify  them. 


Getting  to  Know  the  Desktop 

Now  that  you’ve  created  an  application  object,  you’re  ready  to  look  at  the 
Applications  Generator  desktop  more  closely. 

The  Applications  Generator  desktop  has  several  elements.  The  Applications 
Generator  menu  bar  and  information  lines  at  the  top  and  bottom  of  the 
screen,  respectively,  provide  you  with  the  tools  for  creating  your  application. 
The  work  surface  is  where  you  position  your  objects  just  as  you  want  them  to 
appear  when  your  application  is  run.  Figure  2-5  illustrates  these  elements. 
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Generate  Preset 


This  Is  an  APPLICATION  OBJECT. 

Type  Information  here  or  greetings  to  your  users. 
See  Application  menu  to  use  as  slgn-on  banner. 


Figure  2-5  Elements  of  the  Applications  Generator  desktop 

The  Applications  Generator  Menu  Bar 

The  Applications  Generator  menu  bar  is  a  horizontal  bar  menu  with  associ¬ 
ated  pull-down  menus.  To  try  out  the  menu  bar,  press  F10  Menus.  Move 
across  the  menu  bar  by  using  the  cursor  keys.  The  -*>  and  ♦-  keys  move 
the  cursor  across  the  horizontal  bar,  and  i  and  f  move  the  cursor  through 
the  options  in  the  menus.  These  navigational  keys  and  others  are  listed  in 
Table  2-2. 


TIP 

Another  way  to  choose  a  menu  from  the  Applications  Generator  menu 
bar  is  to  press  Alt  and  the  first  letter  of  the  menu  name.  For  example, 
to  move  from  the  Design  menu  to  the  Exit  menu,  press  Alt-E.  You  can 
also  use  this  method  from  the  work  surface. 


A  quick  way  to  choose  an  option  in  the  menus  is  to  use  the  first  letter 
of  the  option  —  for  example,  pressing  P  in  the  Design  menu  selects 
Pop-up  menu  and  displays  the  list  associated  with  this  option.  Press 
Esc  to  exit  the  list. 


The  Applications  Generator  menu  bar  is  dynamic,  meaning  that  its  options 
change  depending  on  the  object  that  is  current,  or  selected  by  you.  For 
example,  when  an  application  object  is  current,  the  menu  bar  automatically 
displays  Application.  The  options  in  the  Application  menu  allow  you  to 
specify  attributes  for  your  application  (for  example,  you  can  change  its  name 
or  description). 

The  menus  on  the  Applications  Generator  menu  bar  are  briefly  described  in 
the  following  pages.  Take  a  look  at  the  options  in  each  menu  as  you  read  the 
descriptions. 
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Design 

You  choose  the  type  of  object  you  want  to  create  or  modify  from  the  Design 
menu.  The  options  in  this  menu  always  appear  the  same.  Brief  descriptions 
of  each  option  follow. 

Horizontal  bar  menu.  This  option  allows  you  to  create  a  menu  in  the  same 
style  as  the  Application*  Generator  menu  bar. 


Figure  2-6  Horizontal  bar  menu 

Pop-up  menu.  A  pop-up  menu  is  a  general  term  that  describes  both  pull¬ 
down  menus  (menus  attached  to  a  horizontal  bar  menu)  and  any  other  verti¬ 
cal  menus  in  your  application. 


Stand-aJone 
pop-up  menu 


Pul-down  type 
pop-i4>  m«nu 


JOBNAME:  No  Job  Name  PAGE:  10  SESS:  3  OUTPUT:  Tue  Jun  14  00:15:25  1988 
CLS:  manhat  GRP:  manhat  JOB:  manappgen  DIV:  agchap2 


Files  list.  A  Files  list  is  similar  to  a  menu,  except  it  displays  a  single  type  of 
item:  the  names  of  files  available  to  the  users  of  your  application. 


4=08:55  pn 


Position  utth=  it  -  <  Entsr >  to  sslsct  cholcs  -  <  FI  >  Hslp 


Figure  2-8  Files  list 


Structure  list.  A  Structure  list  gives  the  field  names  of  a  database  or  view 
that  you  want  to  make  available  to  the  users  of  the  application. 


4=10=57  p« 
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CITY 

FIRSTNANE 

LASTNANE 

PHONE 

STATE 

ZIP 


Position  uith  =  it  -  <Entar>  to  salact  cRolcs  -  <  FI  >  Hslp 


Figure  2-9  Structure  list 
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Values  list.  A  Values  list  gives  the  field  values,  or  contents,  of  a  particular 
field  in  one  of  the  database  files  or  views  used  in  your  application. 


Barrlgan 

Caldlcott 


Position  wtth'  it  -  <Entar>  to  salact  cholca  -  <n>  Halp 


Figure  2-10  Values  list 

Batch  process.  A  batch  process  works  behind  the  scenes,  performing  actions 
without  the  intervention  of  the  user.  In  other  words,  the  user  doesn’t  see  the 
object  at  work.  For  example,  you  could  create  a  batch  process  that  automati¬ 
cally  copies  a  file  and  packs  a  database  file. 
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Application,  Menu,  List,  and  Batch 

When  you  select  an  object  on  the  work  surface,  the  second  menu  on  the 
Applications  Generator  menu  bar  changes  to  reflect  your  choice.  For 
example,  if  the  current  object  is  a  horizontal  bar  menu,  the  menu  changes 
to  Menu.  The  menu  can  change  to  Application,  Menu,  List,  or  Batch, 
depending  on  what  type  of  object  is  current.  You’ll  see  this  happen  in  the 
next  section. 

The  options  in  the  Application,  Menu,  List,  and  Batch  menus  allow  you  to 
assign  particular  attributes  to  that  object.  For  example,  from  Menu,  you 
could  choose  the  Write  help  text  option.  This  option  allows  you  to  create 
help  text  related  to  a  menu. 


NOTE 

From  the  Application  menu,  you  can  also  automatically  build  a  single¬ 
menu  ( pop-up )  application.  This  application  allows  users  to  append, 
edit,  browse,  and  pack  a  database  file  that  you  specify.  It  will  also  run 
a  report  and  label  and,  if  assigned  an  index,  it  will  have  an  option  to 
reindex.  For  more  information,  refer  to  Generate  quick  application  in 
the  “Reference”  tab  section  of  this  manual. 


Item 

You  must  make  an  object  other  than  an  application  object  current  before 
Item  appears  on  the  Applications  Generator  menu  bar.  To  do  this,  follow 
these  steps: 

1 .  Choose  Pop-U  )  menu  from  the  Design  menu. 

2.  Choose  <  create  >  from  the  displayed  list. 

A  dialog  box  appears  in  which  you’re  asked  to  enter  the  name,  descrip¬ 
tion,  and  message  line  prompt. 

3.  For  now,  just  enter  testpop  in  the  Name  field,  and  press  Ctrl-End. 

The  cursor  appears  in  the  empty  object  frame  on  the  work  surface,  and 
Menu  and  Item  appear  in  the  Applications  Generator  menu  bar.  Type 
the  following  items  in  this  pop-up  menu  object: 

Add  a  record 
Edit  a  record 
Quit 

4.  Now  press  F10  Menus  and  review  the  options  in  the  Item  menu. 

The  options  in  the  menu  allow  you  to  define  what  action  a  menu  item, 
batch  item,  or  list  does.  For  example,  choose  Change  action  to  see  some 
of  the  actions  an  item  in  the  pop-up  menu  might  perform. 
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Notice  that  the  last  item  in  the  menu,  Quit,  appears  in  the  middle  of  the 
status  bar.  That  is  the  currently  selected  item  to  which  you'd  assign  an 
action  (probably  the  Quit  action).  To  make  another  item  current  quickly, 
press  PgUp  until  the  item  you  want  appears  in  the  status  bar.  (You  can 
also  use  PgDn  to  move  down  an  item.) 

Press  Esc  to  exit  the  submenu. 


NOTE 

To  avoid  confusion  between  the  Applications  Generator  menu  bar  and 
the  menu  objects  in  your  application,  menu  options  refer  to  the  Appli¬ 
cations  Generator  menu  system,  and  menu  items  refer  to  the  actions 
you  assign  in  your  application  menu  objects. 


Generate 

This  menu  always  appears  on  the  Applications  Generator  menu  bar.  It  pro¬ 
vides  options  for  generating  a  description  of  each  of  your  objects,  and  for 
generating  the  dBASE  code  that  allows  you  to  run  your  application.  Figure 
2-12  shows  a  sample  of  object  documentation.  (See  the  “Reference”  tab  sec¬ 
tion  for  more  information  about  generating  documentation.) 


A  sample  of  application  code  is  shown  in  Figure  2-13.  (You’ll  generate  code 
for  the  sample  application  in  the  next  chapter.  For  detailed  information 
about  generating  code,  see  the  “Generate”  section  in  the  “Reference”  tab 
section.) 
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Preset 

This  menu  always  appears  on  the  Applications  Generator  menu  bar.  It  allows 
you  to  specify  defaults  for  how  your  future  applications  will  look  (for  exam¬ 
ple,  the  type  of  border  around  pop-up  menus).  Each  application  you  create 
in  the  Applications  Generator  will  automatically  have  the  defaults  you  speci¬ 
fied  from  the  Preset  menu  before  the  application  was  created.  You  can 
change  them  for  a  particular  application  if  you  wish  by  choosing  options 
from  the  Application  menu. 

Exit 

This  menu  always  appears  on  the  Applications  Generator  menu  bar.  It  pro¬ 
vides  options  for  saving  or  abandoning  changes  you  made  to  the  application 
and  exiting  the  Applications  Generator. 


Selecting  Options 

As  you  saw  when  reviewing  the  Item  menu,  some  options  in  menus  lead  to 
submenus.  The  ►  symbol  to  the  left  of  some  options  indicates  that  the  option 
leads  to  another  menu  from  which  you  can  make  selections. 
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Many  options  lead  to  dialog  boxes,  which  prompt  you  for  information.  To  see 
a  dialog  box,  choose  the  Item  menu,  Change  action  option,  and  the  Edit 
form  action.  Some  fields  in  these  types  of  boxes  allow  you  to  enter  the  infor-  ! 
mation  by  typing  it  or  by  pressing  Shift-FI  Pick  to  choose  from  a  displayed 
list.  (Using  the  second  method  helps  prevent  entry  errors.*) 

Other  fields  in  dialog  boxes  display  a  default  value.  You  can  see  the  other 
possible  values  for  a  field  of  this  type  by  pressing  the  Spacebar  or  the  first 
letter  of  a  choice  if  you  know  it.  For  example,  go  to  the  Mode  field  and  press 
E  for  edit.  This  manual  most  often  cites  the  Spacebar  technique,  but  you  can 
use  either  of  the  two  methods. 

Later,  you’ll  see  smaller  boxes  in  which  you’re  asked  to  make  a  simple  selec¬ 
tion  or  prompted  to  enter  information  in  one  field.  To  make  a  selection,  use 
the  keystroke  choices  described  for  dialog  boxes.  To  save  your  selection  and 
exit  these  types  of  boxes,  press  «-*. 


NOTE 

For  more  detailed  information  about  the  Applications  Generator  menu 
system,  see  the  “ Reference ”  tab  section. 


Help  in  the  Applications  Generator 

The  Applications  Generator  provides  various  kinds  of  helpful  information. 
Refer  to  the  screen  and  Figure  2-15  as  you  read  the  description  of  the  help 
system. 
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Helpful  Information  on  the  Screen 

■  The  status  bar  near  the  bottom  of  the  Applications  Generator  desktop 
tells  you  which  dBASE  IV  component  you're  using,  which  drive  and 
object  is  current,  and  gives  you  row,  column,  and  file  information  if 
appropriate. 

■  The  navigation  line  just  under  the  status  bar  describes  important  keys.  It 
also  provides  informatiOn-about  how  to  navigate  between  objects  and 
items  on  the  work  surface. 

■  The  message  line  at  the  bottom  of  the  screen  explains  the  menu  option 
you  selected  or  the  data  needed  in  a  dialog  box.  It  also  displays  error 
messages. 

Context-Sensitive  Help 

Pressing  FI  Help  displays  a  box  that  contains  information  about  the  particu¬ 
lar  object  or  action  you’re  specifying.  Try  it  now.  Use  the  buttons  at  the  bot¬ 
tom  of  the  box  to  see  the  contents  of  Help,  view  related  topics,  or  print  the 
Help  box.  Messages  at  the  bottom  of  the  screen  give  you  further  information 
about  navigating  through  the  Help  system. 


The  Work  Surface 

The  application  object  and  pop-up  menu  you’ve  created  are  displayed  on  the 
work  surface  of  the  Applications  Generator  desktop.  The  work  surface  is  a 
“what  you  see  is  what  you  get’’  (WYSIWYG)  environment.  That  means  vou 
can  position  and  size  each  object  on  the  work  surface  the  way  you  want  it  to 
appear  when  the  application  is  run. 
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If  you’re  still  using  the  Applications  Generator  menu  bar,  press  E*C  until  the 
cursor  returns  to  the  work  surface.  To  make  the  application  object  current 
(bring  it  to  the  foreground),  press  F3  Previous. 

As  shown  in  Figure  2-5,  the  work  surface  features  tools  to  make  laying  out 
your  application  easier.  The  grid  on  the  work  surface  helps  you  align  objects. 
The  numbers  at  the  bottom  of  the  screen  represent  column  position.  The 
numbers  in  the  left  margin  of  the  work  surface  represent  the  screen  lines  of 
vour  application. 

Note  that  the  work  surface  starts  with  the  first  line  labeled  0  and  ends  with 
20.  Line  0  is  the  top  of  the  screen  when  the  application  is  run.  If  you  want 
access  to  all  lines  on  a  standard  24-line  screen,  press  F9  Zoom,  which  causes 
the  Applications  Generator  menu  bar  and  information  lines  to  disappear. 
Pressing  F9  Zoom  again  brings  them  back  to  the  screen. 

You  move  and  size  objects  and  make  other  navigational  choices  by  using  the 
other  function  keys.  The  following  table  explains  how  each  function  key  is 
used.  Once  you  press  the  appropriate  function  key,  the  message  line  tells  you 
how  to  proceed.  If  you  don't  want  to  study  this  table  and  the  one  that  follows 
now,  skip  to  the  next  section  and  refer  to  the  tables  later. 
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Table  2-1  Function  key  assignments 


Function  key 

FI  Help 

Explanation 

Provides  Help  wherever  you  are  in  the  Applications 
Generator 

F3  Previous 

Moves  cursor  to  the  previous  object  on  the  work  surface, 
making,  that  object  current 

F4  Next 

Moves  cursor  to  the  next  object  on  the  work  surface,  mak¬ 
ing  that  object  current 

F5  Field 

Marks  beginning  and  end  of  an  item  when  entering  it  in  a 
horizontal  bar  menu  («-J  may  also  be  used  instead  of  the 
second  F5  to  finish) 

F7  Move 

Allows  moving  an  object  to  a  new  location  on  the  work 
surface,  or  an  item  and  all  its  attributes  to  a  new  location 
in  the  object  or  to  a  different  object  of  the  same  type 

F8  Copy 

Allows  copying  an  item  to  another  location  in  the  same 
object  or  to  a  different  object  of  the  same  type 

F9  Zoom 

Displays  or  removes  the  Applications  Generator  menu  bar 
and  information  lines,  giving  a  full  screen  on  which  to  lay 
out  objects 

F10  Menus 

Moves  cursor  from  an  object  on  the  work  surface  to  the 
Applications  Generator  menu  bar 

If  in  a  menu,  selects  the  current  option 

Shift-FI  Pick 

Displays  a  list  when  the  cursor  is  on  a  field  that  allows  a 
selection 

Shift-F2  Design 

From  Control  Center,  displays  selected  application  for 
modification 

Shift-F7  Size 

Allows  changing  of  the  length  and  width  of  the  frames  that 
enclose  an  object 

TIP 

^  Use  the  function  key  template  that  you  received  in  your  dBASE  IV 
IHtf  package  as  a  reminder  of  these  function  key  assignments. 

Other  navigation  keys  are  listed  in  Table  2-2. 
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Table  2-2  Navigational  keys 


Key  Action 

In  an  object,  editing  frame,  or  dialog  box,  moves  cursor  one 
position  to  the  left 

In  a  bar  mfiju,  moves  cursor  one  option  to  the  left  and 
opens  an  attached  pull-down  menu.  Wraps  through  options. 

In  a  multiple-choice  list,  exits  the  list  and  returns  to  the  dialog 
box  from  which  it  was  invoked 

-►  In  an  object,  editing  frame,  or  dialog  box,  moves  cursor  one 

position  to  the  right 

In  a  bar  menu,  moves  cursor  one  option  to  the  right  and 
opens  an  attached  pull-down  menu.  Wraps  through  options. 

In  a  multiple-choice  list,  exits  the  list  and  returns  to  the  dialog 
box  from  which  it  was  invoked 

f  In  an  object,  editing  frame,  or  dialog  box,  moves  the  cursor 

one  position  up 

In  a  pop-up  menu,  moves  one  option  up  (wraps  around  in 
menus) 

i  In  an  object,  editing  frame,  or  dialog  box,  moves  one  position 

down 

In  a  pop-up  menu,  moves  one  option  down  (wraps  around  in 
menus) 

PgUp  Moves  cursor  to  the  previous  item  in  the  menu  or  batch 

process 

In  a  list,  moves  one  page  up 

PgDn  Moves  cursor  to  the  next  item  in  the  current  object  on  the 

work  surface 

In  a  list,  moves  one  page  down 

Backspace  In  an  object,  full-screen  editing  frame,  or  dialog  box,  deletes 
previous  character 

Dal  Deletes  the  current  character  or  item 

Home  In  a  dialog  box  or  list  moves  to  the  first  field  or  option, 

respectively 

In  a  menu  or  full-screen  editing  frame,  moves  to  the  beginning 
of  the  line 


Ins  Toggles  Insert  on  and  off 

End  In  a  dialog  box  or  list  moves  to  the  last  field  or  option, 

respectively 

In  a  menu  or  full-screen  editing  frame,  moves  to  the  end  of 
the  line 

(i continued) 
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Table  2-2  Navigational  keys  (continued) 


Key 

Action 

Tab 

In  an  editing  frame,  moves  to  the  next  tab 

In  a  dialog  box,  moves  to  the  first  character  of  the  next  field 

Shift-Tab 

In  an  editing  frame,  moves  to  previous  tab 

In  a  dialog  box,  moves  to  first  character  of  previous  field 

In  an  Applications  Generator  menu,  executes  the  currently 
highlighted  option 

In  a  dialog  box,  confirms  choice  and  moves  to  the  next  field 

In  an  object  or  full-screen  editing  frame,  moves  to  the  begin¬ 
ning  of  the  next  line 

Spacebar 

In  a  field  with  choices,  cycles  through  the  choices 

In  an  object,  editing  frame,  or  dialog  box,  moves  one  space  left 

Esc 

In  an  editing  frame  or  dialog  box,  cancels  the  changes  made 
and  exits 

In  the  Applications  Generator  menu,  exits  to  the  current  object 
on  the  work  surface 

In  an  Applications  Generator  submenu,  exits  to  the  calling 
menu 

In  an  object,  cancels  all  unsaved  changes  made  to  any  object 
during  the  current  session  and  asks  whether  to  exit  the  Applica¬ 
tions  Generator 

Cancels  a  move  or  copy 

Alt-  <  key  >  In  combination  with  the  first  letter  of  the  desired  menu,  moves 
the  cursor  quickly  to  an  Applications  Generator  menu 


Ctrl-End 

In  a  dialog  box,  editing  frame,  or  multiple-choice  list,  saves  the 
entries  and  returns  the  cursor  to  the  originating  menu  option 

In  submenus,  exits  to  previous  level 

In  pull-down  menus,  returns  to  the  work  surface 

In  an  object,  saves  all  changes  and  exits  the  Applications 
Generator 

Ctrl-H 

Ctrf-N 

In  a  full-screen  editing  frame,  deletes  previous  character 

In  an  object  or  an  editing  frame,  inserts  a  line  above  the  line 
indicated  by  the  cursor 

Ctrt-T 

Ctrl-W 

Deletes  to  the  end  of  the  current  word 

In  a  dialog  box  or  full-screen  editing  frame,  saves  the  entry  and 
returns  the  cursor  to  the  originating  menu  option 

Ctri-Y 

In  an  object  or  an  editing  frame,  deletes  the  line  indicated  by 
the  cursor 

Ctrl-*- 

In  an  editing  frame,  moves  to  start  of  a  word 

Ctrl— ► 

In  an  editing  frame,  moves  to  beginning  of  the  next  word 
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Moving,  Resizing,  and  Copying 

You  move,  resize,  and  copy  objects  and  items  on  the  work  surface.  An  object 
must  be  current,  or  selected,  to  perform  these  operations.  If  there  are  multi¬ 
ple  objects  on  the  work  surface,  press  F3  Previous  or  F4  Next  until  the  object 
you  want  to  make  current  appears  in  the  foreground.  Pressing  Esc  abandons 
any  of  these  operations.  Use  the  row  and  column  information  in  the  status 
bar  to  help  you  move  or  copy  an  object. 

To  get  some  practice  with  these  operations,  follow  the  instructions  in  the 
next  few  paragraphs. 

Moving  Objects  and  Items 

To  move  the  pop-up  menu  object,  press  F3  Previous  and  follow  these  steps: 

1 .  Press  F7  Move  and  choose  Entire  frame  from  the  box  that  appears  by 
pressing  «-*. 

The  object  frame  begins  to  flash,  indicating  that  you  can  begin  the  move. 

2.  Reposition  the  pop-up  menu  object  anywhere  you  want  it,  using  the  cur¬ 
sor  keys. 

A  new  frame  appears  as  you  move  the  object. 

3.  When  you've  positioned  the  new  frame,  press  «-*. 

The  original  object  moves  to  the  new  frame.  Note  that  if  you  overlay  one 
object  with  another,  the  bottom  object  remains  intact. 

To  move  an  item  to  a  new  location  in  the  object  or  to  a  different  object,  do 
these  steps: 

1 .  Select  the  Quit  item  and  press  F7  Move. 

2.  Select  Item  only  from  the  box  that  appears. 

3.  Use  the  cursor  keys  to  move  Quit  to  the  next  line  of  the  object,  and  press 
«-■  to  complete  the  move. 

(To  move  the  item  to  another  object,  use  F3  Previous  or  F4  Next  to  select 
the  object,  and  then  do  step  3.) 


a 


NOTE 


An  item  cannot  be  moved  on  top  of  other  text.  You  can,  however, 
move  it  to  its  previous  location. 


You  can  also  insert  an  item  between  two  others  by  pressing  Ctri-N  to 
create  a  blank  line  and  moving  the  item  there. 
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Sizing  Objects 

To  resize  the  pop-up  menu  object,  follow  these  steps: 

1.  Press  Shift-F7  Size,  which  causes  the  object  frame  to  flash. 

2.  Use  the  cursor  keys  to  make  the  pop-up  menu  object  larger  or  smaller. 

A  new  frame  appears  as  you  resize  the  object. 

3.  When  you’re  finishe'd,' press  «->. 

Note  that  the  object  frame  must  be  larger  than  the  items  within  it.  List 
objects  can  only  be  made  larger  than  their  default  size,  not  smaller. 

Copying  Items 

For  the  test  application,  skip  the  following  instructions.  When  you  want  to 
copy  an  item  in  your  own  applications,  refer  to  these  steps. 

To  copy  an  item  to  another  location,  either  within  that  object  or  to  another 
like  object  (for  example,  from  one  pop-up  menu  to  another),  do  these  steps: 

1 .  Select  the  item  and  press  F8  Copy. 

2.  Use  the  cursor  keys  to  position  the  item  in  the  new  location. 

(If  moving  to  another  object,  use  F3  Previous  or  F4  Next,  and  then  do 
step  2.) 

3.  When  you're  finished  positioning  the  item,  press  4-*. 


NOTE 

When  you  copy  an  item,  all  the  attributes  (for  example,  the  assigned 
action)  associated  with  the  original  item  also  apply  to  the  copy  unless 
you  change  them. 


Working  in  Frames 

As  you've  seen,  when  you  first  create  an  object,  an  empty  frame  in  which  you 
can  enter  menu  or  batch  process  items  appears  on  the  work  surface.  (If  you 
created  a  list  object,  the  items  will  be  represented  by  Xs.) 

Don’t  worry  about  making  mistakes  as  you  type.  You  can  make  changes  with 
editing  techniques  you’ve  already  used  in  other  dBASE  IV  components. 
(Refer  to  Table  2-2  if  you  need  a  refresher.)  Because  text  is  not  automatically 
wrapped  to  the  next  line,  you  must  provide  your  own  carriage  returns  in 
these  frames.  To  increase  the  line  width,  resize  the  frame,  as  explained  in  the 
previous  section,  “Moving,  Resizing,  and  Copying  on  the  Work  Surface. ’’ 
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Sometimes  you'll  use  a  full-screen  editing  frame.  You  use  these  frames  to 
enter  help  text  or  embed  dBASE  code,  for  example.  You  can  enter  up  to  19 
lines  in  a  full-screen  editing  frame.  Like  the  other  frames,  you  must  provide 
vour  own  carriage  returns,  and  press  Ctri-End  to  save  and  leave  the  frame.  To 
see  a  full-screen  editing  frame,  follow  these  steps: 

1.  Press  F10  Menus  to  return  to  the  Applications  Generator  menu  bar. 

2.  From  Menu,  choo§e  Write  help  text. 

You’ll  see  a  full-screen  editing  frame  in  which  you  can  enter  text  that 
will  display  when  the  user  of  your  application  presses  FI  Help. 

3.  For  now,  press  Esc  to  exit  the  frame  without  saving  it. 


Leaving  the  Applications  Generator 

After  you’ve  defined  objects  to  meet  your  design  requirements,  you  can  gen¬ 
erate  object  documentation  or  generate  code  to  run  the  application.  Object 
documentation  describes  the  objects  you  created  and  is  useful  as  a  record  of 
your  application.  Code  is  needed  to  test  and  distribute  your  application.  Or, 
you  can  simply  leave  the  Applications  Generator  until  another  work  session. 

The  steps  for  creating  a  complete  application  and  for  generating  documen¬ 
tation  and  code  can  be  found  in  the  next  chapter.  For  the  test  application, 
you’ll  leave  the  Applications  Generator  without  generating  code  and 
documentation. 

1 .  Go  to  the  Exit  menu. 

2.  Choose  Abandon  all  changes  and  exit. 

The  Applications  Generator  asks  you  to  confirm  that  you  want  to  aban¬ 
don  all  changes. 

3.  Press  •*-  to  choose  Yes  and  press 

You  then  return  to  the  Control  Center  or  dot  prompt,  depending  on  the 
component  you  used  to  enter  the  Applications  Generator. 

Now  that  you’re  familiar  with  the  Applications  Generator,  you  can  begin  to 
create  a  fully  functional  application.  In  the  next  chapter,  you’ll  see  a  design 
for  a  sample  application  and  the  steps  for  creating  it. 
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A  Sample 
Application 


This  chapter  describes  how  to  build  a  sample  application  with  the  Applica¬ 
tions  Generator.  First,  you'll  see  the  sample  application  design,  which  you'll 
use  to  create  the  menus  and  other  objects  in  the  Applications  Generator. 
The  reports,  forms,  and  labels  specified  in  this  design  are  provided  with 
dBASE  IV.  This  description  is  followed  by  a  diagram  that  outlines  the  gen¬ 
eral  tasks  you  do  to  build  this  application  in  the  Applications  Generator. 
Finally,  you’ll  see  the  specific  steps  for  doing  so. 


A  Sample  Application  Design 

The  following  design  describes  a  simple  application  that  holds  address  infor¬ 
mation  for  personal  use  —  for  example,  the  information  you’d  ordinarily 
keep  in  an  address  book.  It  also  records  whether  a  person  was  sent  a  holiday 
card,  and  produces  indexed  reports  for  all  names  and  for  holiday  card  recipi¬ 
ents.  When  you  build  this  application,  you'll  assign  the  name  <  INI  >  Names, 
where  <  INI  >  represents  your  initials. 


NOTE 

You  can  use  this  design  approach  as  a  guide  for  the  design  of  your 
own  applications. 


Operational  Flow 

This  application  will  include  the  following  capabilities: 

1.  Users  will  initially  see  an  easy-to-use,  horizontal  bar  menu  of  the  fea¬ 
tures,  which  include  updating  records,  generating  reports  and  labels, 
backing  up  and  packing  the  database  file,  and  exiting  the  application. 
The  items  on  the  horizontal  menu  bar  will  be  Updates,  Reports, 
Maintenance,  and  Exit. 

2.  Users  will  be  provided  with  items  for  the  following  actions: 

■  Add  records,  using  the  Add/Edit/Delete  in  EDIT  action 

■  See  or  edit  multiple  records  on  a  single  screen,  using  the 

Add/Edit/Delete  in  BROWSE  action 
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■  Print  or  display  a  report  of  the  entire  file  indexed  by  name,  using  the 
Display  or  print  action 

■  Print  or  display  a  report  of  the  people  who  received  holiday  cards, 
indexed  by  name,  using  the  Display  or  print  action 

■  Print  labels  for  all  records,  using  the  Display  or  print  action 

■  Print  labels  for  a  holiday  card  mailing,  using  the  Display  or  print 
action 

■  Run  a  batch  process  that  makes  a  backup  copy  and  packs  the  database 
file,  using  the  Run  program  action 

Database  File  Design 

This  application  uses  the  following  database  file: 


Table  3-1  People.dbf  structure 


Field  Name 

Type 

Length 

Description 

LASTNAME 

character 

20 

Last  name 

FIRSTNAME 

character 

20 

First  name 

ADDRESS 

character 

25 

Home  address 

CITY 

character 

15 

City 

STATE 

character 

02 

State 

ZIP 

character 

10 

Zip  code 

PHONE 

character 

13 

Home  phone  number 

CARDSENT 

logical 

01 

Holiday  card  sent? 

This  application  also  uses  a  file  identical  to  People.dbf.  called  Peoplbak.dbf, 
which  serves  as  a  reserve  copy  should  People.dbf  be  destroyed. 


on  how  to  do  so. 


NOTE 

These  database  files  are  provided  for  you  with  dBASE  IV.  If  you  did 
not  install  the  sample  files,  return  to  Getting  Started  for  instructions 


Index  File  Design 

This  application  uses  the  Names  tag  to  index  People.dbf. 

Expression:  UPPER(LASTNAME  +  FIRSTNAME) 
Index  filename:  People. mdx 
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Use  of  the  Database  File 

The  database  file  is  modified  in  the  application  as  follows: 

1 .  A  record  is  added  to  the  database  file  whenever  a  new  name  and  address 
is  entered  in  the  input  form. 

2.  A  record  may  be  edited  or  updated  to  reflect  new  conditions  at  any  time. 

3.  A  record  may  be  marked  for  deletion  from  the  database  file  by  pressing 
Ctrl-U  when  the  record  is  displayed  in  the  table. 


Forms 


This  application  uses  the  following  form  to  input  information  into 
People.dbf: 

Input  form  #1 
Database  file:  People.dbf 
Index  file:  People. mdx 
Form  name:  Addbook.fmt 
Title:  Names  and  Addresses  Form 

Appropriate  titles  for  all  input  fields  on  the  form  include  the  following: 
Last  Name,  First  Name,  Address,  City,  State,  Zip,  Phone,  and  Card  Sent. 


Reports  and  Labels 

This  application  uses  the  following  reports  and  labels: 

Report  #  1 

Database  file  used:  People.dbf 
Index  file:  People.mdx 
Records:  All 

Report  name:  Allnames.frm 

Title:  Names  and  Addresses  of  Friends  and  Acquaintances 

This  report  includes  the  following  headings  in  address  book  format:  Last 
Name,  First  Name,  Address,  City,  State,  Zip,  and  Phone. 

Report  #2 

Database  file  used:  People.dbf 
Index  file:  People.mdx 
Records:  Cardsent  field  is  .T. 

Report  name:  Cardrec.frm 

Title:  Names  and  Addresses  of  Card  Recipients 

This  report  includes  the  following  column  headings:  Last  Name,  First  Name, 
Address,  City,  State.  Zip,  and  Phone. 

Labels  #  1 

Database  file  used:  People.dbf 
Index  file  used:  People.mdx 
Records:  All 

Report  name:  Mailall.lbl 
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This  label  format  includes  the  following  fields:  Firstname,  Lastname, 
Address,  City,  State,  and  Zip. 

Labels  #2 

Database  file  used:  People. dbf 
Index  file:  People. mdx 
Report  name:  Cardonly.lbl 
Records:  Cardsent  field  is  ;T„ 

Each  label  includes  the  greeting  Happy  Holidays  to:  and  the  following  fields 
in  label  format:  Firstname,  Lastname,  Address,  City,  State,  and  Zip. 


Menus 


A  description  of  each  menu  used  in  the  sample  application  follows.  These 
menus  are  created  in  the  Applications  Generator. 

Main  Menu 

The  main  menu  is  a  horizontal  bar  menu  with  the  following  items: 

UPDATES  REPORTS  MAINTENANCE  EXIT 

When  you  build  the  application,  you'll  assign  this  horizontal  bar  menu  the 
name  Main.  When  these  items  are  selected,  the  following  pull-down  menus 
appear: 

Updates  Pull-Down  Menu 

The  Updates.pop  pud-down  menu  is  associated  with  the  UPDATES  item.  It 
has  the  following  items: 

Add  a  record 
Change/Delete  a  record 


Remember  to  back  up  the 
file  after  updates.  See 
Maintenance. 

The  horizontal  line  and  the  text  underneath  it  are  information  lines,  which 
are  automatically  assigned  Text  (no  action)  by  the  Applications  Generator. 

Reports  Pull-Down  Menu 

The  Reports.pop  pull-down  menu  is  associated  with  the  REPORTS  item.  It 
has  the  following  items: 


All  Names  Report 
Card  Report 
All  Records  Labels 
Holiday  Labels 
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Maintenance  Pull-Down  Menu 

The  Maintnce.pop  pull-down  menu  is  associated  with  the  MAINTENANCE 
item.  It  includes  the  following  item: 

Back  up  file 

The  batch  process,  defined  in  this  chapter,  performs  the  item  on  this  pull¬ 
down  menu. 

Exit  Pull-Down  Menu 

The  Exit.pop  pull-down  menu  is  associated  with  the  EXIT  item.  It  includes 
the  following  item: 

Exit  application 

This  item  causes  the  application  to  return  to  the  operating  system. 
Together,  these  menus  will  apppear  as  follows: 


Batch  Process 

The  sample  batch  process  copies  People. dbf  to  a  backup  file  called 
Peoplbak.dbf.  It  also  does  normal  file  maintenance,  including  erasing 
records  marked  for  deletion,  reindexing,  and  removing  the  disk  space  used 
by  the  deleted  records  (as  in  the  PACK  command).  The  user  runs  the  batch 
process  by  choosing  the  Back  up  file  item  from  Maintnce.pop.  When  you 
build  the  application,  you’ll  assign  this  batch  process  the  name  Backup. 
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Item  Actions 

The  following  narratives  describe  what  happens  when  a  user  chooses  one  of 
the  main  menu  items. 

Updates 

The  items  on  this  menu  give  the  user  the  choice  of  adding  records,  or  chang¬ 
ing  and  deleting  records  from  People. dbf.  When  adding  records,  the  program 
enters  append  mode  and  an  empty,  single-record  input  form  appears 
(Addbook.fmt).  Users  save  the  new  record  by  pressing  Ctrl-End  or  moving  off 
the  last  field  in  the  form. 

If  change  or  delete  is  chosen,  a  table  of  records  displays  in  indexed  order. 
The  users  browse  through  the  database  file  using  PgUp  and  PgDn,  or  f  and  j, 
and  change  or  delete  information  as  they  go.  They  use  standard  dBASE  edit¬ 
ing  techniques  to  update  the  database  file. 

Reports 

Items  on  this  menu  allow  users  to  choose  a  report  or  label.  When  they 
choose  a  label,  printing  begins.  When  they  choose  a  report,  they  can  display 
or  print  the  report.  The  user  cannot  make  changes  directly  to  the  report 
or  label. 

Maintenance 

This  menu  allows  t  sers  to  copy  People.dbf  to  a  backup  file  and  do  normal 
file  maintenance,  including  erasing  records  marked  for  deletion,  reindexing, 
and  reclaiming  the  disk  space  allocated  to  the  deleted  records  (as  in  the 
PACK  command).  This  item  performs  the  batch  process  described  earlier. 

Exit 

This  menu  allows  users  to  return  to  the  operating  system  once  they’ve  fin¬ 
ished  working  in  the  application. 


Using  the  Sample  Application  Design 

To  use  this  design,  the  sample  files  must  be  in  the  current  directory,  and 
Samples  should  be  the  current  catalog.  You  can  use  Dbsample.bat,  a  batch 
file  in  your  dBASE  directory,  to  start  dBASE  IV  when  you’re  working  with 
the  sample  files.  Just  enter  dbsample  at  the  DOS  prompt.  Dbsample.bat 
changes  to  the  directory  with  your  sample  files  before  executing  dBASE  IV. 
You’ll  see  the  database,  forms,  reports,  and  label  files  for  the  sample  applica¬ 
tion  displayed  in  the  Control  Center  panels. 

Now  you  use  the  Applications  Generator  to  create  the  menus  and  batch 
process  for  the  application.  You  can  use  the  diagram  and  steps  that  follow 
to  help  you  build  the  application. 
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Preset  menu  options 

determine  how  - 

application  object 
first  appears 


Enter  the  Applications 
Generator  from 
Applications  panel  in 
the  Control  Center 


From  Design  menu, 
choose  ofejeot  to  create, 
suoh  as  main  menu 


From  objeot  menu 
(Application,  Menu, 

List  or  Batch)  assign 
attributes  to  each  object 


From  Item  pull-dovn 
menu,  specify  action 
that  each  item  in  each 
object  vill  perform 


From  Generate  menu, 
specifg  MENU. GEN 
template  to  generate 
code  and  DOCUMENT  .GEN 
to  generate  documentation, 
and  then  select  Begin 
generating 


From  Exit  menu,  save 
changes  and  return 
to  Control  Center 


At  dot  prompt,  print 
documentation  and  cede 


Run  application  bg 
selecting  it  from 
Applioatiens  panel 
in  Control  Center 


Repeat  step  until 
all  objects  for 
your  application 

are  created 


Figure  3-2  Building  the  sample  application 
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Building  the  Sample  Application 

The  steps  below  describe  how  to  build  the  sample  application  in  the  Appli¬ 
cations  Generator.  These  instructions  take  an  hour-and-a-half  to  two  hours 
to  complete.  If  you  need  to  leave  your  work  before  finishing,  simply  press 
F10  Menus  to  return  to  the  Applications  Generator  menu  bar  (if  needed). 
Then  choose  Save  all  changes  and  exit  from  the  Exit  menu.  You’ll  return 
to  the  Control  Center,  where  you  can  end  your  session.  To  start  up  again, 
select  your  application  from  the  Applications  panel  and  continue  where 
you  left  off. 

While  you  must  define  an  application  object  first,  you  can  build  the  other 
objects  (menus  and  batch  process)  and  assign  actions  to  each  item  in  any 
order  you  wish.  These  instructions,  however,  emphasize  creating  all  the 
objects  first  and  assigning  actions  to  the  items  later.  To  get  the  broad  picture 
of  the  tasks  involved  in  building  a  sample  application,  refer  to  Figure  3-2. 


Defining  an  Application  Object 

Defining  the  application  object  is  the  first  step  you  take  when  building  any 
application  in  the  Applications  Generator. 

1 .  From  the  Control  Center,  choose  <  create  >  from  the  Applications 
panel,  and  press  «-*. 

2.  From  the  dialog  box  that  appears,  use  -►  to  choose  Applications 
Generator  and  press  «-*. 

You’ll  see  the  dialog  box  shown  in  Figure  3-3. 


Design  Application  Generate  Preset  Exit 


Accept'  Ctrl -End  Cancel'  Esc 
Enter  the  nee  of  the  application  gou  are  creating 


Figure  3-3  New  application  definition 


3.  At  Application  name,  enter  the  name  of  the  sample  application, 
<  INI  >  NAMES,  where  <  INI  >  represents  your  initials. 
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4.  At  the  Description  field,  enter  a  description  of  the  sample  application  — 
for  example.  Names,  Addresses,  and  Holiday  Card  Recipients. 

5.  At  the  Main  menu  type  field,  accept  the  default  BAR,  which  indicates  a 
horizontal  bar  menu. 

6.  At  the  Main  menu  name  field,  enter  MAIN,  the  name  of  the  main  menu 
for  the  sample  application. 

7.  At  the  Database/view  field,  press  Shift-FI  Pick  to  select  PEOPLE  from 
the  displayed  list. '  * 

The  database  file  you  specified  is  the  default  database  file  for  this 
application.  It  is  used  by  every  menu  and  batch  process  in  the  sample 
application. 

8.  At  the  Set  INDEX  to  field,  enter  PEOPLE. MDX,  the  name  of  the  produc¬ 
tion  .mdx  file. 

9.  At  the  ORDER  field,  enter  Names,  which  is  a  tag  in  People. mdx. 

10.  When  finished,  press  Ctrt-End. 

You  see  the  entire  Applications  Generator  desktop  with  the  defined  appli¬ 
cation  object  on  the  work  surface,  and  Application  displayed  in  the 
Applications  Generator  menu  bar. 

The  application  object  always  remains  on  the  work  surface.  The  informa¬ 
tion  in  it  comes  from  the  default  information  specified  with  Preset  menu 
options. 

In  the  next  section,  you'll  specify  that  this  object  be  the  first  screen  dis¬ 
played  when  the  application  starts.  When  used  in  this  way,  the  applica¬ 
tion  object  becomes  a  sign-on  banner.  To  prepare  the  object  to  be  a  sign- 
on  banner,  follow  the  next  step. 

11.  Erase  the  default  information  by  typing  over  it  (or  by  pressing  Ctrl-Y  to 
remove  lines),  and  add  a  greeting  to  your  users  —  for  example, 

<  Your  Name  >  ’s  Name  and  Address  Manager. 


NOTE 

The  remaining  instructions  in  this  chapter  assume  that  you  know  how 
to  get  to  the  Applications  Generator  menu  bar  (by  pressing  F10  Menus 
or  Alt  plus  the  first  letter  of  a  menu  on  the  Applications  Generator 
menu  bar)  and  that  you  know  to  press  «-<  when  choosing  options  from 
the  Applications  Generator  menu  bar  or  from  a  displayed  list. 


Specifying  Attributes  for  an  Application 

You  can  modify  and  define  certain  attributes  of  an  application  by  using  the 
options  on  the  Application  menu.  For  example,  you  can  change  its  name 
and  description  or  specify  new  colors  for  the  objects  in  your  application.  For 
the  sample  application,  you’re  going  to  specify  that  the  application  object 
serve  as  a  sign-on  banner. 

1 .  From  the  Application  menu,  choose  Display  sign-on  banner. 

2.  Choose  Yes  from  the  dialog  box  that  appears,  and  press  ♦-J. 
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3.  To  save  this  application  object,  choose  Save  current  application 

definition  from  the  Application  menu. 


Defining  a  Menu 

While  you  can  build  the  remaining  objects  in  any  order,  a  logical  place  to 
start  is  with  the  main  menu.  For  the  sample  application,  the  main  menu  is  a 
horizontal  bar  menu.  In  the-future,  you  can  use  a  horizontal  bar  menu  for  a 
main  menu,  including  associated  pull-down  menus,  or  your  main  menu  can 
be  a  pop-up  or  batch  process  type. 

Defining  a  Horizontal  Bar  Menu 

A  horizontal  bar  menu  is  often  used  as  a  main  menu  in  an  application.  The 
process  of  creating  horizontal  bar  menus  differs  from  that  of  other  objects 
because  you  use  F5  Field  to  mark  the  beginning  and  end  of  an  item. 

1.  From  the  Design  menu,  choose  the  Horizontal  bar  menu  option. 

2.  From  the  displayed  list,  choose  <  create  >  . 

A  dialog  box  appears  in  which  you  enter  the  name,  description,  and 
message  line  prompt  for  this  menu. 

3.  In  the  Name  field  enter  MAIN. 

Notice  that  this  is  the  name  of  the  main  menu  you  specified  when  you 
created  the  application  object. 

4.  In  the  Description  field,  enter  Names  and  Addresses  Main  Menu. 

5.  Skip  the  Message  line  prompt  field. 

The  messages  for  each  attached  pull-down  menu,  which  you'll  specify 
later,  will  tell  the  user  how  to  navigate  in  your  application. 

6.  Press  Ctrt-End  to  finish  the  definition.  The  cursor  displays  at  the  top  left- 
hand  corner  of  the  work  surface  within  a  frame. 

Now  you're  going  to  type  the  items  for  this  horizontal  bar  menu. 

7.  Press  F5  Field  to  mark  the  position  of  the  first  item  of  the  horizontal  bar 
menu. 

8.  Enter  UPDATES,  and  press  F5  Field  again  to  mark  the  end  of  the  item. 

9.  Use  the  Spacebar  or  -►  to  position  the  next  item,  and  repeat  steps  7  and 
8  for  the  following  items:  REPORTS,  MAINTENANCE,  and  EXIT. 

10.  If  the  items  on  this  menu  bar  are  not  spaced  to  your  preference,  remove 
spaces  between  the  items  with  the  Del  key,  or  insert  spaces  by  pressing 

Ina  and  the  Spacebar. 

Assigning  Attributes  to  a  Menu 

Next,  you’re  going  to  specify  that  the  horizontal  bar  menu  will  automatically 
display  its  pull-down  menus. 

1.  Choose  Attach  pull-down  menus  from  Menu. 
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2.  Answer  the  prompt  Pull  down  associated  menus...  by  choosing  Yes. 

3.  To  save  the  menu  and  remove  it  from  the  work  surface,  choose  Put 
away  current  menu  from  Menu.  From  the  dialog  box  that  appears, 
accept  the  default,  Save  changes. 


WARNING 

When  designing  your  own  applications,  choosing  the  Attach  pull¬ 
down  menus  option  might  produce  unexpected  results.  Before 
designing  your  application,  refer  to  “About  Inheritance”  near  the 
beginning  of  the  "Reference”  tab  section. 


Defining  a  Pop-Up  Menu 

A  pop-up  menu  can  be  a  vertical  menu  that  appears  alone  or  a  pull-down 
menu  attached  to  a  horizontal  bar  menu  item. 

Defining  a  pop-up  menu  is  essentially  the  same  process  as  defining  a  hori¬ 
zontal  bar  menu.  The  major  difference  is  that  you  just  type  the  items  in  the 
object  frame,  rather  than  pressing  F5  Reid  before  and  after  the  item. 

For  the  sample  application,  you’ll  create  pop-up  menus  that  serve  as  the  pull¬ 
down  menus  to  each  item  on  the  horizontal  bar  menu  you  just  created. 

1 .  Choose  the  Pop-up  menu  option  from  Design. 

2.  From  the  list  that  displays,  choose  <  create  >  . 

3.  In  the  Name  field,  enter  UPDATES. 

4.  In  the  Description  field,  enter  This  is  the  pull-down  menu  for  the  UPDATES 
item. 

5.  In  the  Message  line  prompt  field,  enter  Use  the  up  and  down  cursor  keys 
to  choose  options  from  this  menu. 

6.  Press  Ctrl-End  to  finish  the  definition  and  display  the  object  on  the  work 
surface. 

7.  Press  Shift-F7  Size  and  use  the  -►  to  widen  the  borders  of  the  frame 
about  one-half  inch  (use  the  grid  to  guide  you).  To  finish,  press  «->. 

Resizing  the  frame  was  necessary  to  accommodate  the  width  of  one  of 
the  items,  which  you’ll  type  in  next. 
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8.  In  the  object  frame,  type  the  following  items  for  the  Updates  pull-down 
menu: 

Add  a  record 
Change/Delete  a  record 


Remember  to  back  up  the 
file  after  updates.  See 
Maintenance. 

The  dotted  line  and  the  text  below  it  are  informational  items  (Text 
(no  action))  only. 

9.  To  save  the  menu  and  remove  it  from  the  work  surface,  choose  Put 
away  current  menu  from  Menu.  From  the  dialog  box  that  appears, 
accept  the  default,  Save  changes. 

Follow  steps  1  through  6  and  8  through  9  to  create  each  of  the  remaining 
three  pull-down  menus  of  the  sample  application.  (You  need  not  resize  these 
menus.)  The  other  pull-down  menu  names  are  REPORTS,  MAINTNCE,  and 
EXIT.  You  can  add  descriptions  and  message  line  prompts;  however,  they're 
not  required  to  run  the  application.  The  items  for  each  of  these  pull-down 
menus  follow.  You'll  need  this  information  to  complete  step  8  of  the  process 
just  described. 

REPORTS 

All  Names  Report 
Card  Report 
All  Records  Labels 
Holiday  Labels 

MAINTNCE 
Back  up  file 
EXIT 

Exit  application 

Next  you’re  going  to  define  the  batch  process. 


NOTE 

For  more  information  about  the  options  in  the  Menu  menu,  see  the 
“Reference"  tab  section  later. 
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Defining  a  Batch  Process 


Use  a  batch  process  when  you  want  to  assign  more  than  one  action  to  an 
item.  The  batch  process  does  these  tasks  behind  the  scenes  —  that  is,  with¬ 
out  the  intervention  of  the  user.  The  batch  process  in  the  sample  application 
copies  People. dbf  to  a  backup  file,  Peoplbak.dbf.  It  then  packs  the  database 
file,  which  includes  erasing  records  marked  for  deletion,  reindexing,  and 
reclaiming  the  disk  space  used  by  the  erased  records. 

1 .  Choose  Batch  process  from  the  Design  menu. 

2.  From  the  list  that  appears,  choose  <  create  >  . 

3.  In  the  Name  field,  enter  BACKUP. 

4.  In  the  Description  field,  enter  COPY  and  PACK  batch  process  for  the 
Back  up  file  item. 

5.  Press  Ctri-End  to  finish  the  definition  and  display  the  batch  object  on  the 
work  surface. 

6.  Type  the  actions  you  want  the  batch  process  to  do,  one  action  to  a  line  as 
follows: 

Copy  People.dbf  to  Peoplbak.dbf 
Pack  People.dbf 

7.  To  save  the  batch  process  object  and  remove  it  from  the  work  surface, 
choose  Put  away  current  batch  process  from  Batch.  Then  accept  the 
default,  Save  changes. 


Now  you’re  going  to  assign  actions  to  each  object,  item  by  item. 


Assigning  Actions  to  an  Object 

The  next  step  involves  assigning  actions  to  the  objects  you  just  defined.  The 
actions  you  assign  now  will  be  performed  when  you  run  your  application 
later. 

Assigning  Actions  to  a  Menu 

First,  you’re  going  to  assign  actions  to  the  horizontal  bar  menu. 

1.  Choose  Horizontal  bar  menu  from  the  Design  menu. 

2.  From  the  displayed  list,  choose  MAIN. 

3.  Choose  the  first  item  in  the  main  menu:  UPDATES. 

4.  Choose  Change  action  from  the  Item  menu. 

A  menu  appears  from  which  you  can  choose  an  action. 

5.  Choose  Open  a  menu. 

You'll  see  a  dialog  box  in  which  yo,u’re  asked  to  provide  the  menu  type 
and  name  this  item  will  open. 

6.  Choose  the  menu  type  by  pressing  the  Spacebar  until  POP-UP  displays 
in  the  Menu  type  field. 
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7.  In  the  Menu  name  field,  enter  UPDATES. 

8.  Press  Ctri-End  to  finish,  and  then  PgDn  to  move  to  the  next  item, 

REPORTS. 

Notice  that  REPORTS  appears  in  the  center  of  the  status  bar  at  the  bot¬ 
tom  of  the  screen.  You  can  use  PgDn  and  PgUp  as  a  short-cut  method  of 
selecting  items  in  an  object. 

You’re  going  to  assign  the  Open  a  menu  action  to  the  other  three  items 
in  this  main  menu.  So,  repeat  the  previous  steps,  changing  the  name  in 
the  Name  field  accordingly  (see  step  8).  For  the  REPORTS  item,  assign 
the  pop-up  menu  REPORTS.  For  the  MAINTENANCE  item,  assign  the 
pop-up  menu  MAINTNCE.  For  the  EXIT  item,  assign  the  pop-up  menu 
EXIT.  When  you're  finished,  choose  Put  away  current  menu  from  Menu 
and  select  Save  changes  from  the  dialog  box. 

The  process  just  described  is  used  to  assign  actions  to  other  menu  items.  To 
use  this  process  for  the  other  menu  items,  see  the  steps  and  table  that  follow. 

1 .  Make  another  menu  current  by  choosing  it  from  the  Design  menu.  For 
example,  choose  UPDATES  from  the  Pop-up  menu  option  in  Design. 

2.  Select  an  item  in  the  menu  —  for  example,  Add  a  record. 

3.  Look  at  Table  3-2  to  determine  which  action  you  should  assign  to  the 
item. 

4.  From  the  Item  menu,  choose  the  action,  and  follow  the  instructions 
given  in  the  table. 

5.  Choose  the  next  item,  if  any,  in  the  menu,  and  assign  an  action  to  it  as 
specified  in  the  table. 


NOTE 

Remember  to  save  the  item  actions  for  a  menu  when  you've  finished 
specifying  them.  You  do  that  by  choosing  Put  away  current  menu 
from  Menu,  and  selecting  Save  changes  from  the  dialog  box  that 
displays. 
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Table  3-2  Sample  pull-down  items  and  actions 


Menu  Name 

Item 

Action  (from  Item  menu) 

Choose 

UPDATES 

Choose  Add  a  record 

Choose  Change  action 

Choose  Edit  form 

In  FORMAT  file  field,  enter 
ADDBOOK 

Accept  other  defaults  by  pressing 

Ctrl-End 

Choose  Change/Delete 
a  record 

Choose  Change  action 

Choose  Browse 

Accept  defaults  by  pressing 

Ctrl-End 

Remember  to  back  up 
your  file  after  updates. 
See  Maintenance. 

[Since  these  lines  are  Text  (no 
action),  the  default,  you  don’t 
need  to  assign  an  action  to  them.] 

Choose 

REPORTS 

Choose  All  Names 
Report 

Choose  Change  action 

Choose  Display  or  print 

Choose  Report 

In  the  Form  name  field,  enter 

ALLNAMES 

At  Send  output  to,  choose  ASK 

AT  RUN  TIME  (press  the 

Spacebar  to  display) 

Accept  other  defaults  by  pressing 

Ctrl-End 

Choose  Card  Report 

Choose  Change  action 

Choose  Display  or  print 

Choose  Report 

In  the  Form  name  field,  enter 
CARDREC 

At  Send  output  to,  choose 

ASK  AT  RUN  TIME  (press  the 
Spacebar  to  display) 

In  the  FOR  field,  enter 

CARDSENT 

Accept  other  defaults  by  pressing 

Ctrl-End 

Choose  All  Records 
Labels 

Choose  Change  action 

Choose  Display  or  print 

Choose  Labels 

In  the  Form  name  field,  enter 

MAILALL 

Accept  defaults  bv  pressing 

Ctrl-End 

(i continue <S) 
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Table  3-2  Sample  pull-down  items  and  actions  (continued) 


Menu  Name 

Item 

Action  (from  Item  menu) 

Choose  Holiday  Labels 

Choose  Change  action 

Choose  Display  or  print 

Choose  Labels 

In  the  Form  name  field,  enter 
CARDONLY 

In  the  FOR  field,  enter 

CARDSENT 

Accept  defaults  by  pressing 

Ctrt-End 

Choose 

MAINTNCE 

Choose  Back  up  file 

Choose  Change  action 

Choose  Run  program 

Choose  Execute  BATCH  process 

In  the  Batch  name  field,  enter 
BACKUP 

Choose  EXIT 

Choose  Exit 
application 

Choose  Change  action 

Choose  Quit 

Choose  Quit  to  DOS 

Press  at  the  OK  prompt 

Assigning  Actions  to  a  Batch  Process 

The  steps  to  assign  actions  to  batch  process  items  are  the  same  as  those  used 
to  assign  actions  to  menu  items.  Batch  processes  are  special,  however,  in 
that  you  first  assign  the  action  to  run  the  batch  process  to  a  menu  item  or 
list.  Then  you  spe  :ify  the  actions  the  batch  process  performs  when  the  user 
selects  the  menu  item. 

For  the  sample  application,  you’ve  already  assigned  the  action  to  run  the 
Backup  batch  process  to  the  Back  up  file  item  in  the  Maintenance  pull¬ 
down  menu.  Next,  you’re  going  to  specify  the  actions  that  the  batch  process 
performs  when  the  menu  item  is  selected  by  the  user. 

1.  From  the  Design  menu,  choose  Batch  process. 

2.  From  the  displayed  list,  choose  BACKUP. 

The  batch  process  object  appears  on  the  work  surface  with  the  items  you 
specified  earlier. 

3.  Choose  the  first  item,  Copy  People.dbf  to  Peoplbak.dbf. 

4.  From  the  Item  menu,  choose  Change  action  and,  from  the  submenu 
that  displays,  the  Perform  file  operation  option. 

You’ll  see  a  list  of  actions. 

5.  Choose  Copy  records  to  file. 

A  dialog  box  appears  in  which  you’re  asked  to  enter  the  database  file  to 
which  you  wish  to  copy  People.dbf. 

6.  Press  Shift-FI  Pick  and  choose  PEOPLBAK. 
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7.  Accept  the  of  type  default,  and  press  Ctri-End  to  finish. 

8.  Press  PgDn  to  display  the  next  item,  Pack  People. dbf,  in  the  status  bar 
near  the  bottom  of  the  screen. 

9.  From  Item,  select  Change  action  and  Perform  file  operation. 

10.  From  the  submenu,  choose  the  Discard  marked  records  option,  and 
press  «-!  to  confirm  your  choice. 

1 1.  To  save  the  batch  process  and  remove  it  from  the  work  surface,  choose 
Put  away  current  batch  process  from  Batch.  From  the  dialog  box  that 
appears,  accept  the  default,  Save  changes. 


NOTE 

For  more  information  on  the  actions  you’re  assigning  to  items,  note 
the  command  equivalent,  which  appears  to  the  right  of  each  action. 
Then  refer  to  Language  Reference  for  an  explanation  of  the 
command. 


Laying  Out  the  Application 

Now  that  you've  defined  the  objects  of  your  application  and  assigned  actions 
to  the  items  in  the  menus  and  batch  process,  you're  ready  to  lay  out  the 
application.  This  determines  what  your  users  see  when  your  application  is 
run. 

First,  retrieve  the  main  menu  for  your  application. 

1.  From  Design,  choose  Horizontal  bar  menu. 

2.  From  the  displayed  list,  choose  MAIN. 

The  main  menu  of  your  application  appears  at  the  top  of  the  work  sur¬ 
face.  Next,  retrieve  the  pull-down  menus.  By  moving  and  resizing  the 
pull-down  menus,  you  can  make  your  application  aesthetically  pleasing. 

3.  To  retrieve  the  Updates  menu,  choose  Pop-up  menu  from  Design. 

4.  From  the  displayed  list,  choose  UPDATES. 

The  Updates  menu  appears  on  the  work  surface. 

5.  To  position  the  menu  under  the  UPDATES  item,  press  F7  Move  and 
accept  the  default.  Entire  frame,  from  the  dialog  box. 

6.  Use  •*-  and  f  to  position  the  flashing  frame  under  UPDATES.  To  accept 
the  new  position,  press  «-J 

7.  To  resize  the  menu,  press  Shift-F7  Size  and  use  the  cursor  keys  to 
remove  or  add  extra  space  to  your  menu.  When  you're  satisfied  with  the 
results,  press  «-*. 
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Use  steps  1  through  5  as  a  guide  for  positioning  the  other  pull-down  menus 
in  the  sample  application.  Note  that  you  can  overlay  the  pull-down  menus 
if  the  items  in  them  are  wider  than  the  space  between  the  items  in  the  hori¬ 
zontal  bar  menu.  When  the  application  is  run,  only  one  pull-down  menu  dis¬ 
plays  at  a  time.  So,  don’t  worry  if  the  items  in  one  pull-down  menu  overlap 
the  items  of  the  pull-down  menu  beside  it  at  this  stage.  You  can  also  move 
back  to  the  horizontal  bar  menu  by  pressing  F3  Previous,  and  add  spaces 
between  the  items. 

8.  To  get  a  better  idea  of  how  your  application  will  appear  at  run  time, 
press  F9  Zoom. 

Pressing  this  key  removes  the  Applications  Generator  menu  bar  and 
information  lines  at  the  bottom  of  the  screen.  When  you're  ready  to 
proceed,  press  F9  Zoom  again. 

9.  To  save  the  new  layout,  choose  Clear  work  surface  from  Application  or 
Menu.  When  prompted,  choose  Save  changes  for  each  object. 

Next,  you’ll  generate  the  object  documentation  and  code  for  running  your 
application. 


Generating  Object  Documentation  and  Code 

Object  documentation  is  a  record  of  the  objects  you  created.  When  printed, 
it’s  useful  for  noting  changes  you  want  to  make  as  the  application  is  run.  The 
dBASE  programs  generated  to  run  your  application  constitute  the  code. 

Generating  Obje  it  Documentation 

To  generate  the  object  documentation  for  your  application: 

1.  Choose  the  Display  during  generation  option  from  the  Generate  menu. 
Choose  Yes  to  see  the  object  documentation  as  it's  generated. 

2.  Choose  Select  template  from  the  Generate  menu. 

3.  Type  the  documentation  template  name,  DOCUMENT.GEN,  and  press  «->. 

4.  Select  Begin  generating. 

A  small  box  appears  in  which  you’re  asked  whether  you  have  an  IBM 
graphics  compatible  printer.  This  type  of  printer  will  give  you  better 
quality  object  documentation  when  you  print  it  later. 

5.  Accept  the  default,  N  (for  No),  or  type  Y  (for  Yes),  and  press  «->. 

You'll  see  the  object  documentation  as  it's  generated.  The  Applications 
Generator  creates  an  object  documentation  file  called  <  INI  >  Names.doc, 
where  <  INI  >  represents  your  initials,  for  this  application. 
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Generating  Code 


To  generate  the  dBASE  programs  to  run  your  application: 

1.  Choose  the  Display  during  generation  option  from  the  Generate  menu. 
Choose  Yes  to  display  the  code  as  it’s  generated. 

2.  Choose  Select  template  from  the  Generate  menu. 

3.  Type  the  code  template  name,  MENU. GEN,  and  press  *-J. 

4.  Select  Begin  generating. 


You’ll  see  the  code  as  it’s  generated.  When  you  look  in  your  disk  directory, 
you’ll  see  the  two  program  files  that  run  the  application.  The  Applications 
Generator  produces  an  <  appname  >  .prg  file  and  a  <  mainmenu  >  .prg  file 
for  each  application. 


NOTE 

For  information  about  the  Quickapp.gen  template,  refer  to  the 
“Application”  section  in  the  “Reference"  tab  section.  To  create  your 
own  templates,  see  the  Template  Language  manual,  which  comes  with 
the  dBASE  IV  Developer's  Edition. 


Now  that  you've  generated  the  object  documentation  and  the  code,  you're 
ready  to  leave  the  Applications  Generator,  print  the  object  documentation 
and  code,  and  test  your  application. 


Saving  Changes  and  Exiting 

To  save  your  changes  and  exit  the  Applications  Generator,  choose  the  first 
menu  option  from  Exit. 

The  Applications  Generator  saves  all  the  changes  made  since  the  last  time 
you  saved.  Then  the  Applications  Generator  returns  to  the  Control  Center. 


Printing  Object  Documentation  and  Code 

Printing  the  object  documentation  that  the  Applications  Generator  creates 
can  help  you  evaluate  your  application  and  serve  as  a  hard-copy  record  of 
your  work.  You  print  object  documentation  from  the  dot  prompt.  To  leave 
the  Control  Center,  press  F10  Menus  and  choose  Exit  to  dot  prompt  from 
the  Exit  menu. 

To  print  the  object  documentation,  make  sure  your  printer  is  ready  and  that 
you  have  SET  HEADING  to  OFF.  Then,  enter  TYPE  <  INI  >  Names.doc  TO 
PRINTER,  where  <  INI  >  represents  your  initials. 

Printing  Code 

Now  you’re  going  to  print  the  code  that  you've  generated.  A  printed  version 
of  the  code  is  useful  when  you  begin  to  run  and  test  your  application.  You 
can  more  easily  trace  errors  if  you  have  the  printed  code.  You  enter  the  com¬ 
mands  to  print  the  code  at  the  dot  prompt. 
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1.  To  print  the  general  procedures  and  environmental  settings,  enter  TYPE 
<  INI  >  Names. prg  TO  PRINTER,  where  <  INI  >  represents  your  initials. 

2.  To  print  the  code  for  object  actions,  and  object  and  item  level  help,  enter 
TYPE  Main. prg  TO  PRINTER.  (Main. prg  is  the  name  of  the  main  menu, 
plus  the  .prg  extension.) 


Testing  Your  Application 

Testing  (also  known  as  debugging)  your  application  allows  you  to  detect  any 
problems  in  the  design  of  your  application,  the  appearance  of  your  user 
interface,  or  in  the  code.  You  use  the  object  documentation  to  record  any 
design  and  interface  changes  you  want  to  make,  and  the  printed  version  of 
the  code  to  note  any  errors  that  prevent  the  application  from  running. 

To  test  your  application  from  either  the  dot  prompt  or  from  the  Control 
Center,  you  need  to  take  a  preliminary  step.  To  run  the  application  from  the 
dot  prompt,  first  enter  set  trap  on.  This  setting  causes  debugging  information 
to  display  when  errors  in  the  code  are  encountered.  Then  enter 
DO  <  INI  >  Names,  where  <  INI  >  represents  your  initials. 

To  run  the  application  from  the  Control  Center,  first  enter  assist  at  the  dot 
prompt,  select  Settings  from  the  Tools  menu,  and  then  change  TYap  to  ON. 
Next,  select  the  application  from  the  Applications  panel,  and  accept  the 
default,  Run  application,  from  the  prompt  box  that  appears. 

If  you  entered  information  correctly  in  dialog  boxes  and  frames  as  you  built 
the  sample  application,  it  will  be  successfully  compiled  (translated  into  a  lan¬ 
guage  that  the  computer  can  understand),  and  it  will  run  as  designed.  If 
you’ve  made  errors,  the  debugger  window  will  display  error  descriptions  and 
the  code  line  numbers  on  which  they  appear. 

If  you  followed  the  previous  instructions  and  entered  all  information  exactly 
as  given,  you  probably  won’t  have  compile  or  syntax  errors.  If  syntax  errors 
do  occur,  you'll  need  to  review  the  code  you  printed  and  locate  them.  Then 
you  have  a  couple  of  choices  for  fixing  the  errors.  You  can  use  the  debugger 
window  that  appears  when  errors  are  encountered.  Or,  you  can  note  the 
objects  or  items  that  contain  errors,  and  fix  them  within  the  Applications 
Generator.  Note  that  any  changes  made  outside  of  the  Applications  Genera¬ 
tor  will  not  be  retained  if  you  regenerate  the  code  or  documentation  later. 

The  Applications  Generator  greatly  reduces  the  number  of  errors  you’re 
likely  to  make  because  it  generates  the  code  for  you.  But  there  is  one  com¬ 
mon  error  of  which  you  should  be  aware.  Do  not  use  double  quotation 
marks  (")  within  an  object  frame,  a  help  text  frame,  or  in  a  message  line 
prompt.  You  can  use  them  in  object  description  fields,  code  embeds,  or 
fields  that  prompt  you  for  this  delimiter.  If  you  do  enter  double  quotation 
marks  inadvertently,  you’ll  receive  an  error  message  at  compile  time. 

Other  common  errors  include  incorrectly  entering  field  or  filenames  (a  good 
reason  to  use  the  Shift-FI  Pick  method),  entering  file  or  field  names  that 
don’t  exist  in  the  catalog  or  directory,  and  command  entry  errors  (for  exam¬ 
ple,  when  embedding  or  inserting  dBASE  code  or  when  completing  fields  as 
you  specify  an  action  from  the  Item  menu). 
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NOTE 

You  can  learn  more  about  debugging  your  application  by  referring  to 
“About  Testing  Your  Application"  in  the  “Reference"  tab  section,  the 
DEBUG  and  SET  TRAP  ON  commands  in  Language  Reference,  or 
Programming  with  dBASE  IV  (if  you  purchased  the  dBASE  IV 
Developer's  Edition). 


Enhancing  the  Application 


You  could  enhance  this  sample  application  in  other  ways.  For  example,  you 
could  give  users  the  option  to  request  a  particular  record  when  updating 
People. dbf.  To  do  this,  you’d  create  a  Values  list  that  contained  the  contents 
of  the  Lastname  field.  When  users  wanted  to  change  a  record,  they’d  choose 
a  particular  last  name  from  the  Values  list,  and  the  specified  record  would 
display.  For  more  information,  see  “Giving  the  Users  More  Control”  in  the 
“Reference”  tab  section. 

This  application  can  stand  alone  as  a  simple  application,  or  it  can  be 
included  in  a  more  complex  design  as  one  module  of  a  bigger  application. 
For  example,  a  personal  application  might  include  modules  that  keep  an 
inventory  of  your  personal  possessions,  balance  your  checkbook,  and  remind 
you  of  important  dates,  as  well  as  keep  records  of  names  and  addresses.  Now 
that  you’ve  learned  how  to  use  the  Applications  Generator,  you  can  design 
and  build  these  modules  on  your  own,  or  you  can  begin  building  other 
applications. 


Modifying  Your  Application 

To  change  this  application  or  another  existing  application  from  the  dot 
prompt,  you  would  type  MODIFY  APPLICATION  <  appname  >  and  press 
where  <  appname  >  is  the  name  of  an  application  you  want  to  modify. 

You’ll  see  the  Applications  Generator  desktop  with  your  application  object 
on  it. 

To  change  this  application  or  another  existing  application  from  the  Control 
Center  (when  SET  INSTRUCT  is  ON),  choose  the  application  from  the 
Applications  panel  and  Modify  application  from  die  prompt  box  that 
appears.  Alternatively,  move  the  highlight  to  the  application  name  in  the 

Applications  panel,  and  press  Shift-F2  Design. 

You  can  then  change  the  application  attributes  by  choosing  options  in  the 
Application  menu,  and  by  making  changes  to  the  objects  associated  with 
this  application.  For  example,  you  can  change  actions  that  menu  items  per¬ 
form,  or  fine  tune  the  application  by  adding  help  text  and  changing  color 
attributes.  After  making  the  changes,  you  must  regenerate  the  code  in  order 
to  see  the  changes  reflected  in  the  application  when  it  is  run.  For  more  infor¬ 
mation  about  modifying  an  application,  refer  to  “About  Generic  Applications” 
in  the  “Reference”  tab  section. 
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Distributing  Your  Application 

When  you’ve  become  skilled  in  application  development,  you  may  wish  to 
distribute  vour  applications  to  others.  The  COMPILE  command  creates  .dbo 
files  that  run  quickly  and  discourage  others  from  tampering  with  your  code. 
See  the  Language  Reference  manual  for  more  information  on  this  command. 

In  addition,  you  can  distribute  your  application  to  customers  who  don’t  own 
dBASE  by  using  AshtonTate’s. RunTime  product.  RunTime  is  available  in  the 
dBASE  IV  Developer's  Edition  package.  If  you  didn't  purchase  the  dBASE  IV 
Developer’s  Edition  but  would  like  to  do  so,  return  the  order  card  enclosed 
in  the  dBASE  IV  package  to  AshtonTate. 


About  the  Reference  Section 

To  help  you  build  your  own  application,  the  "Reference”  tab  section  gives 
detailed  information  about  the  Applications  Generator  menus,  submenus, 
and  dialog  boxes  you  use  to  develop  an  application.  Appendix  B  gives  an 
overview  of  the  Applications  Generator  menu  system. 
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Reference 


About  This  Section 

Refer  to  this  section  when  you’re  ready  to  build  your  own  applications.  It 
primarily  describes  the  Applications  Generator  menu  system,  including  each 
menu  on  the  Applications  Generator  menu  bar.  You  should  already  be  famil¬ 
iar  with  the  previous  section,  “The  Basics,”  before  using  this  material. 

To  find  the  information  you  need,  refer  to  the  table  of  contents  or  the  index, 
or  skim  through  the  pages  until  you  find  the  appropriate  heading.  Most  of 
the  major  headings  in  this  tab  section  are  the  menus  of  the  Applications  Gen¬ 
erator  menu  bar  and  are  easy  to  spot. 

Some  options  require  a  knowledge  of  dBASE  syntax  (how  dBASE  commands 
are  entered).  To  help  you  find  information  about  dBASE  syntax  requirements, 
this  tab  section  includes  references  to  the  Language  Reference  manual.  For 
example,  you’ll  see  references  similar  to:  [BROWSE  command,  Language 
Reference]. 


NOTE 

Appendix  B,  “Menu  Trees,"  gives  you  an  overall  picture  of  the  menu 
system. 


About  Dialog  Boxes 

Dialog  boxes  display  when  you  choose  some  options  from  the  Applications 
menu  bar.  Dialog  boxes  contain  prompts  and  fields  in  which  you  enter  data. 


Making  Choices 

You  can  enter  data  for  some  fields  in  the  dialog  boxes  by  typing  it,  or  by 
pressing  Shift-FI  Pick  to  choose  from  a  displayed  list.  For  example,  to  spe¬ 
cify  an  index  file,  you  can  either  type  the  index  filename,  or  you  can  press 
Shift-FI  Pick  to  choose  from  a  list  of  index  files  in  the  current  catalog  or 
directory.  The  second  method  helps  you  avoid  making  entry  errors  that  will 
prevent  the  application  from  running. 
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Other  fields  in  dialog  boxes  display  a  default  value.  You  can  see  the  other 
possible  values  for  a  field  of  this  type  by  pressing  the  Spacebar  or  the  first 
letter  of  a  choice  if  you  know  it.  For  example,  to  choose  a  pop-up  menu 
and  advance  to  the  next  field,  you  could  press  P.  The  instructions  for  each 
dialog  box  suggest  the  Spacebar  technique,  but  you  can  use  either  of  the 
two  methods. 


NOTE 


A  few  small  boxes  require  you  to  make  a  simple  selection  or  prompt 
you  to  enter  information  in  one  field.  To  make  a  selection,  use  the  key¬ 
stroke  choices  described  for  dialog  boxes.  To  save  your  selection  and 
exit  these  types  of  boxes,  press  «— >. 


Creating  Non-Applications  Generator  Objects 


Some  dialog  boxes  include  fields  in  which  you  can  choose  to  create  non- 
Applications  Generator  objects,  such  as  database  files,  reports,  forms,  and 
labels.  For  example,  if  you’re  prompted  to  enter  a  database  file  that  is  not  yet 
created,  you  can  either  name  it  without  creating  it  then,  or  you  can  choose 
<  create  >  from  the  list  that  displays  when  you  press  Shift-FI  Pick.  Choos¬ 
ing  <  create  >  saves  all  the  Applications  Generator  objects,  and  displays  the 
appropriate  design  screen  on  which  to  create  the  object.  For  more  informa¬ 
tion  about  the  possible  approaches  to  application  building,  see  “dBASE  IV 
Applications  Generator  and  Other  Product  Components”  in  Chapter  2  of  this 
manual. 


Saving  and  Exiting 


For  dialog  boxes  and  full-screen  editing  frames,  press  Ctrl-End  to  save  the 
information  you  entered  and  exit  the  box  or  frame.  You  can  also  press  Esc  to 
abandon  the  changes  and  exit  the  box  or  frame.  You  can  save  your  selection 
or  single  entry  and  exit  small  boxes  by  pressing  «->. 


About  Catalogs 


Catalogs  are  a  useful  way  to  organize  the  files  in  a  directory.  If  you  installed 
the  sample  files,  the  Samples  catalog  will  be  active  unless  you  specify  other¬ 
wise.  You  can  also  specify  a  catalog  at  the  dot  prompt.  To  work  without  an 
active  catalog,  however,  you  must  enter  the  Applications  Generator  through 
the  dot  prompt. 

If  you're  using  a  catalog,  make  sure  that  all  non-Applications  Generator 
objects  for  an  application,  such  as  the  database,  index,  and  query  files, 
reports,  labels,  and  forms,  are  in  the  catalog  you  specified.  Objects  not 
in  the  same  catalog  won't  appear  in  the  lists  that  display  when  you  press 
Shift-FI  Pick.  You  can  change  catalogs  only  from  the  dot  prompt  or  Control 


Center. 
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Saved  menus,  lists,  and  batch  processes  are  added  to  the  current  directory, 
not  to  the  catalog.  As  a  result,  they  do  not  appear  in  the  Control  Center. 
When  an  application  object  is  saved,  however,  the  new  application  name  (the 
app  file)  is  added  to  the  catalog  and  so  appears  in  the  Applications  panel  of 
the  Control  Center.  If  you’ve  generated  code  for  the  application,  you  can  run 
it  from  the  Control  Center.  If  you  haven’t  yet  generated  code,  you  can  select 
the  application  from  the  Control  Center  and  choose  Modify  application 
from  the  dialog  box  that  displays. 


NOTE 

For  more  information  about  catalogs,  see  Using  the  Menu  System. 


About  Generic  Applications 

In  the  Applications  Generator,  you  can  work  on  just  one  application  at 
a  time.  To  work  on  an  application  other  than  the  current  one,  you  have 
two  choices.  You  can  save  all  objects,  return  to  the  Control  Center  or  dot 
prompt,  and  enter  the  Applications  Generator  again,  where  you  can  choose 
to  create  or  modify  another  application.  Or,  you  can  rename  the  current 
application,  and  modify  and  save  it. 

To  use  the  application  on  the  work  surface  as  a  model  for  a  new  application, 
change  the  name  of  the  application  object  and  any  objects  you  want  to  mod¬ 
ify  just  for  the  new  application.  Use  the  Name  and  describe  option  in  the 
second  menu  on  the  Applications  Generator  menu  bar.  Then  save  the 
objects,  using  the  Save  current  <  object  >  option  in  the  same  menu. 

Next,  modify  the  objects  associated  with  the  new  application.  When  you 
save  again,  the  Applications  Generator  will  store  the  newly  named  applica¬ 
tion  while  retaining  the  original. 


About  Inheritance 

For  design  purposes,  the  application  object  (.app)  is  the  key  object  in  the 
application,  and  its  filename  appears  in  the  Control  Center  representing  all 
objects  used  in  the  application.  All  Applications  Generator  objects  inherit 
attributes  assigned  to  the  application  object  during  a  session.  For  example, 
when  you  assign  a  database  file  to  the  application  object,  it  is  automatically 
assigned  to  every  new  object  used  by  that  application  unless  you  specifically 
override  the  assignment.  Likewise,  an  item  inherits  the  attributes  of  the 
object  in  which  it  appears. 

If  you  want  a  menu  to  use  a  database  file  other  than  the  one  assigned  to  the 
application  object,  for  example,  you  must  change  the  assignment  using  the 
Override  assigned  database  or  view  option  in  Menu.  This  option  also 
allows  you  to  specify  whatever  database  file  or  view  is  in  effect  at  run  time. 

If  you  save  an  object  with  the  new  attribute  (by  choosing  Save  current 
menu),  the  new  database  file  will  be  used  regardless  of  any  change  you  make 
later  to  the  application  object. 
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If  you  specify  that  pull-down  menus  are  automatically  displayed,  using  the 
Attach  pull-down  menus  option,  the  pull-down  menus  will  inherit  the  attri¬ 
butes  of  the  horizontal  bar  menu.  For  example,  if  you’ve  assigned  a  database 
file  to  a  pull-down  menu  that  is  different  from  the  one  assigned  to  the  hori¬ 
zontal  bar  menu,  the  database  file  assigned  to  the  pull-down  menu  will  be 
overridden  and  the  database  file  assigned  to  the  horizontal  bar  menu  will 
be  used. 

To  keep  the  attributes  of  the  pull-down  menus,  accept  the  default,  No,  in  the 
dialog  box  that  appears  when  you  choose  Attach  pull-down  menus  from 
Menu.  Choosing  No  will  result  in  the  pull-down  menus  displaying  after  the 
user  selects  a  horizontal  bar  menu  item  and  presses  «-*.  With  either  choice, 
the  database  and  view  and  the  Embed  code  attributes  made  to  items  are 
retained. 

Reports  and  forms  used  in  the  application  also  inherit  attributes  from  the 
Applications  Generator  objects  that  use  them.  For  example,  a  report  refer¬ 
enced  by  a  menu  item  will  inherit  the  color  attributes  assigned  to  the  menu 
object,  if  any,  or  those  assigned  to  the  application  object.  Any  attributes 
assigned  to  the  report  or  form  in  dBASE  will  be  overridden  by  the  Applica¬ 
tions  Generator  assignments. 

Except  for  the  application  object,  both  the  Applications  Generator  and  non- 
Applications  Generator  objects  can  be  shared  among  applications.  If  a  pop¬ 
up  menu  is  identical  in  two  applications,  for  example,  you  need  only  ensure 
that  it's  in  the  same  directory  as  the  current  application  object  when  you  run 
the  application.  All  attributes  and  actions  assigned  to  that  pop-up  menu 
when  it  was  last  saved  will  be  automatically  used  in  the  second  application, 
unless  you  modify  them  and  save  the  modifications. 

To  make  universal  changes  to  an  object,  save  the  modifications  under  the 
original  name.  Both  applications  will  then  feature  the  new  attributes  if  you 
regenerate  the  code.  You  thus  only  have  to  make  the  change  once  to  have  it 
reflected  in  all  applications  using  that  menu.  If  the  changes  are  for  the  cur¬ 
rent  application  only,  simply  rename  the  object  and  save  the  modifications. 


Giving  Users  More  Control 

The  Applications  Generator  allows  you  to  control  what  the  user  of  your 
application  is  able  to  do  with  it.  For  example,  you  can  specify  what  database 
files  the  user  can  edit,  browse,  or  copy.  If  you  want  to  give  users  more  con¬ 
trol,  however,  you  can  do  that  in  several  ways. 


&LISTVAL. 

Using  the  &LISTVAL.  macro  substitution  symbol  is  one  way  you  can  give 
users  more  control  when  they  run  your  application.  With  it,  you  can  specify 
an  action  that  takes  the  users’  selection  from  a  list.  For  example,  rather  than 
specifying  a  report  that  will  be  printed  when  users  choose  a  Print  report 
item  from  a  menu,  you  can  present  them  with  a  list  of  reports  from  which 
to  choose. 
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The  following  steps  show  you  how  to  give  users  more  report  choices.  Adjust 
these  steps  for  other  actions  in  which  you  want  to  give  the  user  choices. 

1.  Create  a  Files  list,  specifying  *.frm  files  in  the  Identify  files  In  list 
option.  All  reports  in  the  directory  will  appear  in  the  list. 

2.  Select  the  Print  report  item  in  your  menu,  and  choose  Change  action 
from  the  Item  menu. 

3.  Specify  the  Files  list  name  in  the  Open  a  menu  action. 

4.  Select  the  Files  list,  and  assign  the  Display  or  print  action  to  it,  choos¬ 
ing  Report  from  the  submenu. 

5.  In  the  FORM  name  field,  enter  &LISTVAL.. 

When  your  application  is  run,  the  report  selected  by  the  user  from  the 
Files  list  will  be  used  as  the  form  for  the  Display  or  print  action. 


You  can  enter  &LISTVAL.  in  Item  dialog  boxes  anywhere  a  file,  field,  or 
value  is  expected. 


Embedding  Code 

Embedding  dBASE  code  is  another  way  to  give  more  control  to  your  users. 

If  you  have  a  useful  program  already  written  in  dBASE,  you  can  use  the  pro¬ 
gram  in  an  application  built  with  the  Applications  Generator.  You  do  that  by 
embedding  the  program,  either  by  typing  it  line  by  line  (up  to  19  lines  of 
code)  in  the  frame  that  appears  when  you  choose  Embed  code,  or  by  simply 
entering  DO  <  program  name  >  there. 

If  you  want  to  learn  more  about  writing  programs  to  expand  your  appli¬ 
cation,  see  Language  Reference.  If  you  purchased  dBASE  IV,  also  see 
Advanced  Topics.  If  you  purchased  the  dBASE  IV  Developer’s  Edition, 
also  see  Programming  with  dBASE  IV. 


About  Testing  Your  Application 

Testing  your  application,  also  called  debugging,  is  an  important  step  in  the 
process  of  building  applications.  You  test  your  application  by  running  it.  You 
will  not  be  able  to  run  it,  however,  if  you  have  syntax  errors  that  prevent 
dBASE  from  compiling  the  code  you've  generated  in  the  Applications  Gen¬ 
erator.  Fortunately,  dBASE  tells  you  what  those  errors  are  when  you  attempt 
to  run  an  application  from  the  dot  prompt  or  from  the  Control  Center. 


operating  system  prompt,  dot  prompt,  or  Control  Center,  the  applica¬ 
tion  is  under  the  control  of  dBASE.  For  information  on  running  appli¬ 
cations  from  the  dot  prompt  or  Control  Center,  see  Chapter  3,  “A 
Sample  Application." 


NOTE 

You  can  also  run  an  application  from  the  operating  system  prompt  by 
entering  dbase  <  application  name  >  .  Whether  you  run  it  from  the 
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Syntax  Errors 

When  running  an  application  for  the  first  time,  the  dBASE  code  generated 
by  the  Applications  Generator  is  compiled.  Compiling  translates  the  dBASE 
code  into  a  language  that  the  computer  can  understand.  If  you’ve  made  no 
errors  entering  information  as  you  built  the  application,  the  compile  process 
will  proceed  without  interruption  and  your  application  will  appear  on  the 
screen. 

If,  however,  you’ve  made  a  syntax  error  (a  mistake  in  entering  information 
while  you  were  designing  your  application),  you’ll  see  a  message  at  the  bot¬ 
tom  of  the  screen.  Errors  are  briefly  described  and  the  lines  of  code  that 
contain  the  errors  are  listed. 

Errors  can  have  various  causes.  For  example,  if  you  incorrectly  type  a  file¬ 
name,  the  compiler  will  not  be  able  to  find  the  file,  and  so  will  return  a  mes¬ 
sage  to  you.  Preventing  syntax  errors  is  a  good  reason  for  using  Shift-FI  Pick 
to  choose  file  and  field  names  from  displayed  lists. 

Other  errors  may  result  from  entering  invalid  code  with  the  Embed  code 
option  or  invalid  data  in  fields  when  you're  assigning  actions  to  items.  For 
example,  an  incorrectly  entered  expression  in  the  FILTER  field  of  the 
Browse  dialog  box  may  result  in  a  syntax  error  when  you  try  to  run  your 
application.  That’s  why  you  should  be  sure  to  carefully  enter  data  and  follow 
the  syntax  requirements  for  fields  associated  with  dBASE  commands.  You 
can  learn  how  to  enter  information  in  these  fields  by  referring  to  the  descrip¬ 
tions  of  them  in  this  section  and  by  using  Language  Reference.  Data  entered 
correctly  as  you  create  your  application  will  greatly  reduce  debugging  time. 

You  can  easily  prevent  two  common  errors.  The  first  is  the  inclusion  of  dou¬ 
ble  quotation  marks  (")  in  any  object  or  frame  displayed  to  the  user.  Do  not 
include  double  quc  tation  marks  in  application  objects  or  menus,  or  in  help 
text  or  message  line  prompts.  You  can  use  them,  however,  in  object  descrip¬ 
tion  fields,  code  embeds,  or  fields  that  request  delimiter  information  —  in 
other  words,  in  any  field  or  frame  that  will  not  display  to  the  user.  If  you  do 
include  double  quotation  marks  inappropriately,  a  compile  error  message 
will  display  when  you  try  to  run  your  application.  Another  error  to  avoid  is 
renaming  objects  through  the  operating  system.  Use  the  Applications  Genera¬ 
tor  Name  and  describe  option  to  rename  objects  and  prevent  run  time 
errors. 

Even  if  you’re  careful  when  entering  data,  you’ll  probably  still  have  a  few 
syntax  errors.  Most  programmers  do.  Note  the  lines  of  code  in  which  the 
errors  occur  and  then  refer  to  the  error  message  explanations  and  command 
syntax  requirements  in  Language  Reference.  These  resources  will  help  you 
understand  the  nature  of  the  errors  and  the  steps  to  take  in  fixing  them. 

From  here,  you  can  make  corrections  in  two  ways.  You  can  return  to  the 
Applications  Generator,  find  the  objects  and  the  dialog  box  fields  in  which 
the  errors  were  made,  correct  the  data,  and  then  regenerate  the  code.  Or 
you  can  use  the  debugger  program  to  modify  the  code  directly.  If  SET  TRAP 
is  ON,  the  debugger  window  automatically  displays  when  errors  are  encoun¬ 
tered  as  the  application  is  executed.  Note,  however,  that  these  direct  changes 
to  the  code  will  not  be  reflected  in  the  application  if  you  regenerate  the  code 
later.  Refer  to  Language  Reference  for  information  on  the  SET  TRAP  and 
DEBUG  commands. 
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Design  Errors 

Once  the  application  is  running,  you  may  notice  problems  in  design.  For 
example,  you  may  have  assigned  the  wrong  database  file  to  a  menu  item,  or 
forgotten  to  include  a  feature.  Or  maybe  you  just  want  to  change  the  appear¬ 
ance  of  some  of  the  objects  in  your  application.  These  types  of  modifications 
can  be  easily  addressed  by  returning  to  the  Applications  Generator,  adding 
or  modifying  the  objects, _and  then  regenerating  the  code. 


About  Multi-User  Environments 

Because  the  Applications  Generator  locks  all  files,  it  can  be  used  in  a  multi¬ 
user  environment.  The  applications  you  generate  can  also  be  used  in  a 
single-  or  multi-user  environment. 


Design 


Pop-up  Menu 
Files  list 


Structure  list 
Values  list 


Batch  process 


The  Design  menu  is  always  avail¬ 
able  on  the  Applications  Generator 
menu  bar,  and  it  always  contains 
the  same  options.  These  options 
allow  you  to  create  or  modify  the 
Applications  Generator  objects  for 
your  application.  The  only  Applica¬ 
tions  Generator  object  that  you 
don't  create  from  this  menu  is  the 
application  object,  which  you  cre¬ 
ate  or  modify  when  you  enter  the 
Applications  Generator. 


NOTE 

For  information  about  defining  an  application  object,  see  Chapter  3, 
“A  Sample  Application.” 


The  requirements  for  naming  and  describing  the  objects  for  your  application 
are  given  in  this  section.  The  Applications  Generator  adds  a  three-character 
extension  to  each  name.  The  extensions  vary  with  the  type  of  object,  and  are 
useful  to  know  because  you’ll  see  them  in  your  disk  directory. 
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Table  4-1  Object  extensions 


Object 

Extension 

Application 

.app 

Horizontal  bar  menu 

.bar 

Pop-up  menu 

•pop 

Files  lists 

.fil 

Structure  list 

.str 

Values  list 

.val 

Batch  process 

.bch 

NOTE 

To  modify  an  object  but  keep  a  copy  in  its  original  form,  rename 
it  before  making  changes.  Rename  it  by  choosing  the  Name  and 
describe  option  from  the  second  menu  on  the  Applications  Generator 
menu  bar.  When  saving,  the  Applications  Generator  stores  the  original 
object  and  retains  the  newly  named  object  on  the  work  surface. 


Horizontal  bar  menu 

This  option  specifies  i  menu  in  which  the  items  appear  across  the  screen, 
rather  than  in  a  vertical  presentation.  You  can  associate  a  pop-up  menu  or 
list  with  each  item  on  the  horizontal  bar  menu.  When  associated  with  a  hori¬ 
zontal  bar  menu  item,  these  objects  are  called  pull-down  menus.  The  Appli¬ 
cations  Generator  menu  bar  is  an  example  of  a  horizontal  bar  menu  with 
associated  pull-down  menus. 

Choosing  the  Horizontal  bar  menu  option  displays  a  list  from  which  you 
can  choose  an  already  existing  bar  menu  in  the  current  directory.  You  can 
also  choose  to  create  a  new  horizontal  bar  menu.  If  you  choose  one  of  the 
bar  menus  in  this  list,  the  menu  will  appear  on  the  work  surface.  If  you 
choose  <  create  >  ,  you’ll  see  the  dialog  box  shown  in  Figure  4-1. 
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Figure  4-1  Horizontal  bar  menu  dialog  box 

You  may  use  a  horizontal  bar  menu  as  a  main  menu  with  associated  pull¬ 
down  menus.  However,  the  Applications  Generator  doesn’t  restrict  the  use 
of  horizontal  bar  menus  to  main  menus,  nor  does  it  require  that  a  main 
menu  be  horizontal. 

Name 

This  field  accepts  the  name  of  the  horizontal  bar  menu  that  you’re  creating. 
If  the  horizontal  bar  menu  is  the  main  menu,  you  must  give  it  the  name  you 
specified,  if  any,  when  you  entered  the  Applications  Generator.  Otherwise, 
your  application  won’t  run. 

An  entry  in  this  field  is  required.  Make  sure  it’s  a  valid  dBASE  filename  and 
is  unique  within  the  current  directory.  This  horizontal  bar  menu  object  will 
be  stored  under  this  name  with  the  .bar  extension. 

Description 

This  field  accepts  the  description  you  want  to  appear  in  the  code  and  docu¬ 
mentation  created  with  the  Applications  Generator.  An  entry  in  this  field  is 
not  required.  If  you  review  the  code  or  documentation  later,  the  description 
will  help  indicate  the  purpose  of  this  menu. 

Message  line  prompt 

This  field  accepts  the  message  that  appears  when  users  choose  this  menu. 
Enter  as  many  as  76  characters  in  this  field.  (Double  quotation  marks  are 
not  permitted.)  An  entry  in  this  field  is  not  required. 
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Once  you’ve  entered  the  message  and  press  Ctrl-End,  the  cursor  appears  in 
the  upper  left  comer  of  the  work  surface  within  a  frame,  where  you  can 
enter  the  items  for  this  menu.  (Remember  to  use  F5  Field  to  mark  the  begin¬ 
ning  and  end  of  each  item.)  The  second  option  on  the  Applications  Gen¬ 
erator  menu  bar  changes  to  Menu,  from  which  you  can  specify  further 
attributes  for  this  menu. 


NOTE 

For  more  information  about  creating  a  horizontal  bar  menu,  see 
Menu  option  descriptions,  which  appear  later  in  this  tab  section, 
and  Chapter  3,  “A  Sample  Application.” 


Pop-up  menu 

A  pop-up  menu  contains  a  vertical  list  of  items  that  appear  in  a  menu  frame. 
A  pop-up  menu  can  serve  as  a  main  menu  or  as  a  submenu.  It  can  also  be 
associated  with  a  bar  menu  item  as  a  pull-down  menu. 

Choosing  the  Pop-up  menu  option  displays  a  list  of  all  pop-up  menus  in  the 
current  directory.  You  can  also  choose  to  create  a  new  pop-up  menu.  If  you 
select  one  of  the  pop-up  menus  in  this  list,  the  menu  will  appear  on  the  work 
surface.  If  you  choose  <  create  >  ,  you’ll  see  the  dialog  box  shown  in 
Figure  4-2. 


Figure  4-2  Pop-up  menu  dialog  box 


Name 

This  field  accepts  the  name  of  the  pop-up  menu  that  you’re  creating.  If  the 
pop-up  menu  is  the  main  menu,  you  need  to  give  it  the  same  name  as  the 
one  you  specified,  if  any,  when  you  entered  the  Applications  Generator. 
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An  entry  in  this  field  is  required.  Make  sure  it’s  a  valid  dBASE  filename  and 
that  it’s  unique  within  the  current  directory.  This  pop-up  menu  object  will  be 
stored  under  this  name  with  the  .pop  extension. 

Description 

This  field  accepts  the  description  you  want  to  appear  in  the  code  and  docu¬ 
mentation  created  with  the  Applications  Generator.  An  entry  in  this  field  is 
not  required.  If  you  review  the  code  or  documentation  later,  the  description 
will  help  indicate  the  purpose  of  this  menu. 

Message  line  prompt 

This  field  accepts  the  message  that  will  appear  when  users  choose  this  menu. 
Enter  as  many  as  76  characters.  (Double  quotation  marks  are  not  permitted.) 
An  entry  in  this  field  is  not  required.  The  message  line  prompt  appears  in  the 
code  and  object  documentation  that  the  Applications  Generator  creates. 

Once  you’ve  entered  the  message  and  press  Ctii-End,  a  pop-up  menu  object 
appears  on  the  work  surface.  The  second  option  on  the  Applications  Genera¬ 
tor  menu  bar  changes  to  Menu,  from  which  you  can  specify  attributes  of  this 
menu.  You  can  also  type  the  menu  items  in  the  pop-up  menu  object. 


NOTE 

For  more  information  about  creating  a  pop-up  menu,  see  Menu  option 
descriptions,  which  appear  later  in  this  tab  section,  and  Chapter  3,  “A 
Sample  Application.” 


Files  list 

A  Files  list  contains  a  list  of  files  from  which  your  users  can  choose.  For 
example,  you  may  wish  to  offer  users  a  choice  of  reports  to  print. 

A  Files  list  differs  from  a  menu  in  that  you  assign  one  action  to  be  performed 
when  the  user  chooses  any  item  on  the  list.  (For  a  menu,  you  assign  an 
action  to  each  item  in  the  menu.) 

Choosing  the  Files  list  option  displays  a  list  of  all  Files  list  objects  in  the 
current  directory.  You  also  see  an  option  to  create  a  Files  list  object.  If 
you  select  one  of  the  pop-up  menus  in  this  list,  it  will  appear  on  the  work 
surface.  If  you  choose  <  create  >  ,  you’ll  see  the  dialog  box  shown  in 
Figure  4-3. 
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Figure  4-3  Files  list  dialog  box 


Name 

This  field  accepts  the  name  of  the  Files  list  object  that  you’re  creating. 

An  entry  in  this  field  is  required.  Make  sure  it’s  a  valid  dBASE  filename  and 
is  unique  within  the  cu  rent  directory.  The  Files  list  object  will  be  stored 
under  this  name  with  the  .fil  extension. 

Description 

This  field  accepts  the  description  you  want  to  appear  in  the  code  and  docu¬ 
mentation  created  with  the  Applications  Generator.  An  entry  in  this  field  is 
not  required.  If  you  review  the  code  or  documentation  later,  the  description 
will  help  indicate  the  purpose  of  this  list. 

Message  line  prompt 

This  field  accepts  the  message  that  will  appear  when  users  choose  this  list. 
Enter  as  many  as  76  characters.  (Double  quotation  marks  are  not  permitted.) 
An  entry  in  this  field  is  not  required.  The  message  line  prompt  appears  in  the 
code  and  object  documentation  that  the  Applications  Generator  creates. 

Once  you’ve  entered  the  message  and  press  Ctrl-End,  a  Files  list  object 
appears  on  the  work  surface.  The  second  option  on  the  Applications  Gen¬ 
erator  menu  bar  changes  to  List,  from  which  you  can  identify  the  files  to 
be  included  in  this  list. 


NOTE 

For  more  information  about  defining  a  Files  list,  see  the  List  option 
descriptions  later  in  this  tab  section. 
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Structure  list 


A  Structure  list  contains  a  list  of  the  fields  in  the  currently  assigned  database 
file  or  view.  Users  choose  field  names  from  this  list  to  perform  some  action, 
such  as  determining  which  fields  to  print  in  a  report. 

A  Structure  list  object  differs  from  a  menu  in  that  you  assign  one  action 
to  be  performed  when  users  choose  an  item  or  items  from  the  list.  (For 
a  menu,  you  assign  an  action  to  each  item  in  the  menu.) 


NOTE 

When  the  application  is  run,  users  can  choose  more  than  one  item  in 
a  Structure  list  by  selecting  an  item  and  pressing  «->,  selecting  another 
item  and  pressing  «-*,  and  so  forth,  until  they've  finished.  Then,  they 
press  Ctri-End  to  save  their  choices  and  exit  the  list. 


The  exception  to  choosing  multiple  items  from  a  Structure  list  occurs 
when  the  list  is  automatically  displayed  as  a  pull-down  menu.  When 
attached  to  a  horizontal  bar  menu  item  in  this  way  (with  the  Attach 
pull-down  menus  option),  only  one  item  can  be  chosen  from  the 
Structure  list. 


Choosing  the  Structure  list  option  displays  a  list  of  all  Structure  list  objects 
in  the  current  directory.  You  can  also  create  a  Structure  list  object.  If  you 
select  one  of  the  objects  in  this  list,  it  will  appear  on  the  work  surface.  If  you 
choose  <  create  >  ,  you’ll  see  the  dialog  box  shown  in  Figure  4-4. 
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Name 

This  field  accepts  the  name  of  the  Structure  list  that  you’re  creating. 

An  entry  in  this  field  is  required.  Make  sure  it’s  a  valid  dBASE  filename  and 
is  unique  within  the  current  directory.  The  Structure  list  object  will  be 
stored  under  this  name  with  the  .str  extension. 

Description 

This  field  accepts  the  description  you  want  to  appear  in  the  code  and  docu¬ 
mentation  created  with  the  Applications  Generator.  An  entry  in  this  field  is 
not  required.  If  you  review  the  code  or  documentation  later,  the  description 
will  help  indicate  the  purpose  of  this  list. 

Message  line  prompt 

This  field  accepts  the  message  that  will  appear  when  users  choose  this  list. 
Enter  as  many  as  76  characters.  (Double  quotation  marks  are  not  permitted.) 
An  entry  in  this  field  is  not  required. 

Once  you’ve  entered  the  message  and  press  Ctri-End,  a  Structure  list  object 
appears  on  the  work  surface.  The  second  option  on  the  Applications  Genera¬ 
tor  menu  bar  changes  to  List,  from  which  you  can  identify  the  fields  in  this 
list. 


NOTE 

For  more  information  about  defining  a  Structure  list,  see  the  List 
option  descriptions  later  in  this  tab  section. 


Values  list 

A  Values  list  contains  values  for  a  specific  field  of  the  currently  assigned 
database  file  or  view.  Users  choose  field  values  from  this  type  of  list  to  per¬ 
form  some  action,  such  as  viewing  or  updating  specific  records.  For  exam¬ 
ple,  a  Values  list  might  contain  all  the  values  in  the  City  field  of  the  Clients 
database  file.  Users  could  choose  a  city  for  which  they  want  to  view  records 
—  for  example,  all  clients  who  live  in  Ithaca. 

A  Values  list  differs  from  a  menu  in  that  you  assign  one  action  to  be  per¬ 
formed  when  the  user  chooses  any  item  from  the  list.  (For  a  menu,  you 
assign  an  action  to  each  item  on  the  menu.) 

Choosing  the  Values  list  option  displays  a  list  of  all  Values  list  objects  in 
the  current  directory.  You  also  have  the  choice  to  create  a  Values  list 
object.  If  you  select  one  of  the  objects  in  this  list,  it  will  appear  on  the 
work  surface.  If  you  choose  <  create  >  ,  you’ll  be  prompted  for  entries, 
as  shown  in  Figure  4-5. 
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Figure  4-5  Values  list  dialog  box 


Name 

This  field  accepts  the  name  of  the  Values  list  that  you’re  creating.  An  entry 
in  this  field  is  required. 

Make  sure  it’s  a  valid  dBASE  filename  and  is  unique  within  the  current 
directory.  The  Values  list  object  will  be  stored  under  this  name  with  the 
.val  extension. 


Description 

This  field  accepts  the  description  you  want  to  appear  in  the  code  and  docu¬ 
mentation  created  with  the  Applications  Generator.  An  entry  in  this  field  is 
not  required.  If  you  review  the  code  or  documentation  later,  the  description 
will  help  indicate  the  purpose  of  this  list. 


Message  line  prompt 

This  field  accepts  the  message  that  will  appear  when  users  choose  this  list. 
Enter  as  many  as  76  characters.  (Double  quotation  marks  are  not  permitted.) 
The  message  line  prompt  appears  in  the  code  and  object  documentation  that 
the  Applications  Generator  creates. 

Once  you've  entered  the  message  and  press  Ctfi-End,  a  Values  list  object  will 
appear  on  the  work  surface,  and  the  second  option  on  the  Applications  Gen¬ 
erator  menu  bar  changes  to  List,  from  which  you  can  identify  the  field  you 
want  to  appear  in  the  list. 


NOTE 

For  more  information  about  defining  a  Values  list,  see  the  List  option 
descriptions  later  in  this  tab  section. 
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Batch  process 

A  batch  process  is  a  series  of  actions  performed  when  your  application  is 
run.  You  assign  the  action  to  run  a  batch  process  to  a  menu  item  or  list. 

Then  you  assign  actions  to  be  performed  by  the  batch  process.  The  batch 
process  object  itself  is  never  visible  to  the  user.  For  example,  a  batch  pro¬ 
cess  might  prompt  the  user  for  information  (Insert  dBASE  code  action), 
copy  a  file  (Copy  records  to  file  action),  and  pack  the  database  file 
(Discard  marked  records  action). 

Choosing  the  Batch  process  option  displays  a  list  of  all  batch  process  objects 
in  the  current  directory  to  appear.  You  also  have  the  option  to  create  a  batch 
process  object.  If  you  select  a  batch  process  object  in  this  list,  it  will  appear 
on  the  work  surface.  If  you  choose  <  create  >  ,  you’ll  see  the  dialog  box 
shown  in  Figure  4-6. 


Unlike  the  dialog  boxes  for  other  objects,  this  one  does  not  include  a 
Message  line  prompt  field.  Because  users  don’t  see  the  batch  process 
in  action,  no  message  is  needed. 

Name 

This  field  contains  the  name  of  the  batch  process  that  you’re  creating. 

An  entry  in  this  field  is  required.  Make  sure  it’s  a  valid  dBASE  filename  and 
is  unique  within  the  current  directory.  This  object  will  be  stored  with  the 
.bch  extension. 
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Description 

This  field  contains  the  description  you  want  to  appear  in  the  code  and  docu¬ 
mentation  created  with  the  Applications  Generator.  An  entry  in  this  field  is 
not  required.  If  you  review  the  code  or  documentation  later,  the  description 
will  help  indicate  the  purpose  of  this  batch  process. 

Once  you’ve  entered  the  description  and  press  Ctrl-End,  the  batch  process 
object  appears  on  the  work  surface,  and  the  second  option  on  the  Applica¬ 
tions  Generator  menu  bar  changes  to  Batch. 


NOTE 

For  more  information  about  defining  a  batch  process,  see  the  Batch 
option  descriptions  later  in  this  tab  section. 


Object  Menus  (Application,  Menu,  List,  and  Batch) 

When  you  select  an  object  on  the  work  surface,  the  second  option  on  the 
Applications  Generator  menu  bar  changes  to  reflect  your  choice.  For  exam¬ 
ple,  if  the  current  object  is  a  horizontal  bar  menu,  the  option  changes  to 
Menu.  The  option  can  change  to  Application,  Menu,  List,  or  Batch,  depend¬ 
ing  on  what  type  of  object  is  current. 

The  options  in  the  menus  associated  with  Application,  Menu,  List,  and 
Batch  allow  you  to  assign  particular  attributes  to  an  object.  For  example, 
from  Menu,  you  could  choose  the  Write  help  text  option.  This  option  allows 
you  to  create  help  text  for  your  users  relating  to  a  menu. 


Common  Options 

Even  though  this  second  menu  changes  to  reflect  the  current  object,  many 
of  the  options  in  the  object  menus  are  the  same.  These  common  options  are 
described  next.  For  information  about  options  that  are  unique  to  one  of  the 
menus,  refer  to  the  sections  entitled  Application,  Menu,  List,  or  Batch,  as 
appropriate. 

Name  and  describe 

This  option  is  common  to  all  object  menus.  Choose  this  option  to  modify  the 
name,  description,  or  message  line  prompt  of  an  object. 

You  must  enter  a  valid  dBASE  filename  in  the  Name  field,  and  it  must  be 
unique  within  the  current  directory.  If  you  change  the  name  of  the  object, 
the  newly  named  object  becomes  current  and  carries  all  the  attributes  of  the 
original  object  (for  example,  its  color  assignments)  until  you  change  them. 
The  original  object  is  retained  in  its  last  saved  state  and  can  be  brought  back 
to  the  work  surface  at  any  time. 
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NOTE 

Use  this  field  to  rename  objects,  rather  than  renaming  them  through 
the  operating  system.  Otherwise,  your  application  will  not  run. 


In  the  Description  field,  enter  text  that  will  appear  in  the  object  documen¬ 
tation  or  as  a  comment  in  the  code.  This  description  should  indicate  the  pur¬ 
pose  of  the  object. 

In  the  Message  line  prompt  field,  enter  text  that  will  appear  when  this 
object  is  used  at  run  time.  You  can  enter  up  to  76  characters.  (Double  quo¬ 
tation  marks  are  not  permitted.)  Note  that  this  field  does  not  appear  when 
an  application  or  batch  object  is  current. 

Override  assigned  database  or  view 

This  option  is  common  to  all  object  menus  except  the  application  object. 
Choose  this  option  to  assign  a  database  file  or  view  for  the  current  object 
different  from  the  one  you  assigned  to  the  application  when  you  entered  the 
Applications  Generator. 

After  choosing  this  option,  you  see  the  database  or  view  and  index  files  cur¬ 
rently  assigned  to  this  object.  Change  the  assignments  by  completing  the  fol¬ 
lowing  fields. 

For  this  <  object  >  you  may  use  values 

Make  a  choice  from  this  field  by  pressing  the  Spacebar.  If  you  choose  IN 
EFFECT  AT  RUN  TIME  or  ABOVE,  you  will  not  be  able  to  enter  values 
in  the  fields  that  follow. 

IN  EFFECT  AT  RUN  TIME  allows  you  to  specify  the  database  file  or  view 
that  was  in  use  just  prior  to  the  object  being  displayed.  For  example,  your 
application  displays  a  Files  list  from  which  users  can  choose  a  database  file, 
and  then  a  menu  displays.  For  the  menu  to  use  the  database  file  selected 
from  the  list,  you’d  choose  IN  EFFECT  AT  RUN  TIME.  It  also  allows  you 
to  use  the  database  file  or  view  specified  by  a  calling  object.  For  example, 
Menu  A  opens  Menu  C,  and  Menu  B  also  opens  Menu  C.  When  Menu  C  is 
used  by  the  application,  you  may  want  to  use  the  database  file  or  view 
assigned  to  whatever  menu  opened  Menu  C. 

You  may  enter  values  in  the  following  fields  if  you’ve  chosen  ENTERED 
BELOW. 

Database/view 

Enter  the  database  file  or  view  that  you  want  this  object  to  use  if  it  is  differ¬ 
ent  from  the  one  specified  for  the  application  object.  Type  in  the  name,  or 
press  Shlft-FI  Pick  to  choose  a  database  file  or  view  in  the  current  catalog 
or  directory.  Choosing  the  <  create  >  marker  takes  you  to  a  design  screen, 
where  you  can  create  the  database  file. 
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Set  INDEX  to 

Enter  the  index  files  to  be  used  with  the  database  file  or  view  for  the  current 
object  if  they  differ  from  the  ones  assigned  to  the  application.  Either  type  the 
name  of  the  index  file  or  files,  separated  by  a  comma,  or  use  Shift-FI  Pick  to 
select  from  a  displayed  list  of  index  files. 


NOTE 

You  can  choose- multiple  index  files  by  selecting  a  filename  and  press¬ 
ing  «-J,  selecting  another  filename  and  pressing  «-J,  and  so  forth,  until 
you've  selected  all  the  index  filenames  you  want.  Then,  press  Ctri-End 
to  save  the  choices  and  exit  the  list.  If  a  catalog  is  active,  the  names 
of  .mdx  files  will  not  be  in  the  list.  You  can  type  in  .mdx  filenames, 
however. 


[SET  INDEX  TO  command,  Language  Reference ] 

ORDER 

Enter  the  index  order  or  the  name  of  a  new  controlling  index  if  it  differs 
from  the  one  assigned  to  the  application  object.  [SET  ORDER  TO  command, 
Language  Reference ] 


Write  help  text 

This  option  is  common  to  all  object  menus  except  Application  and  Batch. 

(A  batch  process  does  not  display  to  the  user,  so  help  text  is  unnecessary.) 
Use  this  option  to  write  the  help  text  for  the  object  you’re  defining.  This  help 
text  will  appear  at  run  time  if  the  object  is  displayed  and  the  user  presses 
FI  Help.  If  you  don’t  write  help  text  for  the  object,  the  message  No  help 
defined  will  appear  when  the  user  presses  FI  Help. 

Choosing  this  option  displays  a  full-screen  editing  frame  on  the  work  surface. 
Use  this  frame  to  enter  or  modify  the  help  text.  Press  Ctri-End  to  save  your 
help  text  and  return  to  the  object  menu.  You  can  enter  as  many  as  19  lines 
of  text  in  this  frame.  Do  not,  however,  enter  double  quotation  marks. 


NOTE 

You  can  define  help  text  for  objects  or  for  items  in  an  object.  At  run 
time,  help  text  defined  at  the  item  level  displays  when  the  user  posi¬ 
tions  the  highlight  on  an  item  and  presses  FI  Help.  If  help  text  is 
defined  at  the  item  level,  there's  no  need  to  define  it  at  the  object 
level  because  only  the  item-level  text  will  display. 


Modify  display  options 

This  option  is  common  to  all  object  menus  except  Application  (which  offers 
the  same  choices  under  the  Modify  application  environment  option)  and 
Batch  (because  batch  processes  aren’t  displayed  to  the  user).  The  option  is 
used  to  select  the  display  attributes,  the  settings  that  determine  how  the 
objects  will  appear. 


USING  THE  dBASE  IV  APPLICATIONS  GENERATOR 


4-19 


JOBNAME:  No  Job  Name  PAGE:  20  SESS:  7  OUTPUT:  Fri  Jun  17  15:38:03  1988 
CLS:  manhat  GRP:  manhat  JOB:  manappgen  DIV:  agchap4 


New  attributes  will  change  how  the  current  object  and  any  non-  Applications 
Generator  objects  used  by  the  current  object,  such  as  reports  and  forms, 
appear  at  run  time.  For  example,  if  a  menu  item  prints  a  report,  you’ll  assign 
attributes  to  the  report  as  you  assign  attributes  to  the  menu. 

These  selections  override  the  display  attributes  you  selected  from  the  Preset 
menu  and  the  attributes,  if  any,  you  set  for  the  application  with  Display 
options  in  the  Application  menu. 

The  type  of  frame  appears  to  the  right  of  Object  border  style.  You  can 
change  the  type  to  none,  double,  single,  or  panel  by  pressing  «-*  for  O  for 
Object).  Choose  DOUBLE  for  a  double-line  frame,  SINGLE  for  a  single-line 
frame,  PANEL  for  a  wide  frame,  or  NONE  for  no  frame. 


NOTE 

If  you  choose  NONE,  the  object  frame  becomes  invisible;  however,  the 
frame  still  occupies  its  position  on  the  work  surface.  To  have  a  frame¬ 
less  object  (for  example,  a  horizontal  bar  menu)  appear  on  line  0  at 
run  time,  you  must  modify  the  code  created  by  the  Applications  Gener¬ 
ator.  Use  the  dBASE  program  editor  to  change  the  line  number  of  the 
object  from  1  to  0. 


The  options  below  the  horizontal  line  allow  you  to  specify  colors  for  your 
application.  Select  options  under  Standard  -  All  for  text  and  headings. 

(To  choose  text,  messages,  and  titles,  highlighted  items,  boxes,  and  informa¬ 
tion  elements,  select  Standard  -  All  itself.)  Select  options  under  Enhanced  - 
All  for  object  frames,  fields,  and  highlighted  items.  (To  choose  all  of  these 
options,  select  Enhanced  -  All  itself.)  Brief  descriptions  of  the  options  on 
this  menu  follow. 

Normal  text  sets  the  color  for  text,  such  as  unselected  fields  in  Browse. 

Messages  sets  the  color  for  messages,  such  as  message  line  prompts,  navi¬ 
gation  line  messages,  and  unselected  menu  and  list  items. 

Titles  sets  the  color  for  titles,  such  as  Browse  field  name  headings  and 
Browse  table  grids. 

Highlight  sets  the  color  for  highlighted  items,  such  as  highlighted  menu 
and  list  choices. 

Boxes  sets  the  color  for  object  frames,  including  menus,  lists,  batch 
processes,  and  the  application  (sign-on)  object. 

Information  sets  the  color  for  the  status  line,  the  clock,  and  error  box 
borders. 

Fields  sets  the  color  for  selected  fields  in  Browse  and  fields  that  can  be 
edited. 

When  you  choose  one  of  these  options,  you’ll  see  a  menu  of  colors.  To 
choose  color  combinations,  use  the  f  and  i  keys.  To  move  between  fore¬ 
ground  and  background,  use  the  ■*-  and  -►  keys. 
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For  example,  you  could  select  Fields  and  press  4->  to  display  the  color 
panel.  Then,  you  could  select  a  blue  foreground  color,  move  over  to  the 
Background  panel,  and  select  different  background  colors  to  see  how  input 
fields  would  look  with  different  color  combinations. 

The  type  of  monitor  on  which  the  application  runs  determines  whether  these 
color  settings  will  be  used.  If  the  application  is  run  on  a  system  with  a  mono¬ 
chrome  monitor,  the  default  dBASE  IV  monochrome  settings  will  be  used. 


Embed  code 


This  option  is  common  to  all  object  menus  except  Application.  It  allows  you 
to  add  dBASE  code  that  will  execute  when  the  application  is  run.  For  exam¬ 
ple,  you  could  embed  dBASE  SET  commands  that  aren’t  included  in  the 
default  settings  for  the  application.  The  embedded  code  will  execute  before 
or  after  (or  before  and  after)  the  menu  or  list  is  displayed.  For  a  batch  pro¬ 
cess,  the  code  will  execute  before  or  after  (or  before  and  after)  the  batch 
process  is  run. 

When  you  select  either  Before  or  After,  you  see  a  full-screen  editing  frame. 
You  can  enter  up  to  19  lines  of  dBASE  code  in  this  frame.  The  Applications 
Generator  doesn’t  check  code  syntax,  so  enter  or  modify  the  code  carefully. 
(Use  the  keys  described  in  Table  2-2  of  “The  Basics’’  tab  section  to  modify 
the  code.)  Press  Ctri-End  to  save  and  return  to  the  object  menu.  To  simplify 
this  process,  put  the  code  into  a  .prg  file  using  dBASE,  and  embed  the 
dBASE  instruction  DO  <  program  name  >  .prg. 


NOTE 

This  option  is  for  application  developers  who  know  how  to  program  in 
dBASE.  If  you're  new  to  dBASE,  see  the  Language  Reference  manual 
for  programming  basics  and  a  description  of  each  command.  If  you 
purchased  dBASE  IV,  also  refer  to  Introduction  to  the  Dot  Prompt 
and  Advanced  Topics.  If  you  purchased  the  dBASE  TV  Developer's 
Edition,  also  refer  to  Programming  with  dBASE  IV. 


Save  current  <  object  > 

This  option  is  common  to  all  object  menus.  When  you  choose  this  option, 
the  current  object  is  saved  to  disk  but  remains  on  the  work  surface  so  you 
can  continue  working  with  it. 

Put  away  current  <  object  > 

This  option  is  common  to  all  object  menus  except  Application  (because  the 
application  object  cannot  be  put  away).  When  you  choose  this  option,  you 
can  save  or  abandon  changes  to  the  current  object  before  it’s  removed  from 
the  work  surface. 

Choosing  Save  changes  saves  all  the  work  you  did  to  the  current  object 
since  you  last  saved  it  and  then  removes  the  object  from  the  work  surface. 

Choosing  Abandon  changes  removes  the  current  object  from  the  work  sur¬ 
face  without  saving  the  changes  to  disk. 
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Clear  work  surface 

This  option  is  common  to  all  object  menus.  Use  it  when  you  no  longer  need 
objects  on  the  work  surface.  When  you  choose  this  option,  all  objects  except 
the  application  object  are  removed  from  the  work  surface  one  by  one. 

For  each  object  that  has  been  modified  since  you  last  saved  it,  you  will  be 
given  a  choice  to  Save  changes  or  Abandon  changes.  If  you  select  Save 
changes,  the  current  object  is  saved  before  it’s  removed  from  the  work  sur¬ 
face.  If  you  select  Abandon  changes,  the  object  is  removed  from  The  work 
surface  and  remains  in  its  last  saved  version.  Objects  that  were  not  changed 
are  simply  removed  from  the  work  surface. 


Application 


When  you  create  or  select  an  appli¬ 
cation  to  modify,  an  application 
object  appears  on  the  work  surface 
and  the  Application  menu  displays 
in  the  Applications  Generator  menu 
bar.  This  menu  appears  whenever 
the  application  object  is  current. 

The  application  object  always 
remains  on  the  work  surface  and 
can  be  made  current  by  pressing 
F3  Previous  or  F4  Next  until  it  dis¬ 
plays  in  the  foreground  of  the  work 
surface. 

The  attributes  assigned  from  the  Preset  menu  display  in  the  application 
object  when  it’s  created.  For  example,  if  you’ve  previously  specified  an 
author,  copyright  notice,  and  dBASE  version  in  Preset,  this  default  informa¬ 
tion  will  automatically  appear  in  the  application  object  when  it’s  created. 

You  can  change  this  information  or  add  other  information,  such  as  a  greet¬ 
ing  to  your  users,  in  the  application  object  itself.  The  application  object  can 
also  serve  as  your  application  sign-on  banner,  the  screen  users  see  when  they 
first  start  your  application. 

To  further  define  the  application  object,  choose  options  from  the 
Application  menu.  Descriptions  of  the  options  specific  to  this  menu 
follow. 


Assign  main  menu 

This  option  is  used  to  change  the  main  menu  for  the  current  application. 
This  will  be  the  first  menu  your  users  see  when  they  start  your  application. 
Only  menus  and  batch  processes  can  serve  as  a  main  menu.  A  Files,  Struc¬ 
ture,  or  Values  list  cannot  be  a  main  menu. 


NOTE 

See  the  previous  section  for  options  that  are  common  to  all  object 
menus. 


Display  sign-on  banner 
Edit  program  header  comments 
Modify  application  environment 
Generate  quick  application 


Save  current  application  definition 


Clear  uork  surface 
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To  change  the  menu  type  shown  in  the  Main  menu  type  field,  press  the 

Spacebar 

To  change  the  menu  name,  enter  the  new  name  in  the  Main  menu  name 
field,  or  press  Shift-FI  Pick  to  choose  one  from  the  displayed  list.  The  menus 
displayed  in  the  list  are  the  same  type  as  those  in  the  Main  menu  type  field. 
This  name  replaces  the  name  assigned  when  you  created  the  application. 
Press  Ctrl-End  to  finish  the  assignment  and  return  to  the  Application  menu. 


Display  sign-on  banner 

This  option  displays  the  sign-on  banner  when  your  application  is  run.  The 
sign-on  banner  is  your  application  object.  It  contains  the  options  you  speci¬ 
fied  using  the  Sign-on  defaults  option  in  the  Preset  menu  (before  the  appli¬ 
cation  was  created),  and  any  other  additions,  deletions,  or  edits  you  made 
directly  to  the  default  information  in  the  application  object  itself. 

Answering  Yes  to  the  question  Display  frame  as  “sign-on  banner"  at  run 
time?  displays  the  application  object  as  the  first  screen  users  see.  Answering 
No  starts  your  application  at  the  maun  menu.  Press  «-*  to  save  the  answer 
and  return  to  the  Application  menu. 

Edit  program  header  comments 

This  option  allows  you  to  specify  the  author,  copyright  notice,  and  dBASE 
version.  These  comments  will  appear  in  the  code  and  object  documentation 
created  with  the  Applications  Generator.  If  you  don’t  specify  this  information 
here,  the  information  you  entered  with  the  Preset  menu  option  Sign-on 
defaults  will  be  used  in  the  documentation  and  code  instead.  Once  you’ve 
made  the  changes,  press  Ctrl-End  to  return  to  the  Application  menu. 

Using  this  option  doesn't  affect  the  information  in  the  current  sign-on  ban¬ 
ner  if  you  specified  one.  If  you  want  to  change  the  sign-on  banner  for  the 
current  application,  type  your  changes  in  the  application  object  itself. 


Modify  application  environment 

This  option  allows  you  to  override  the  attributes  specified  with  Preset 
options.  A  submenu  appears  in  which  you  can  choose  to  change  display 
options,  environment  settings,  the  search  path,  or  the  view  or  database 
file  and  index  for  the  application. 


Display  options 

This  option  is  the  same  as  the  Modify  display  options  option,  which  is 
described  earlier  in  this  chapter. 

Environment  settings 

This  option  allows  you  to  turn  the  environment  settings  for  this  application 
on  or  off.  For  example,  specifying  Set  BELL  to  ON  will  sound  a  warning 
signal  when  users  have  entered  invalid  data  or  have  reached  the  end  of  an 
input  area. 
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In  the  to  field  on  the  Set  BELL  line,  you  can  change  the  frequency  and 
duration  of  the  signal  by  entering  two  numbers,  separated  by  a  comma. 

Both  numbers  or  neither  must  be  specified.  The  default  is  550,2. 

In  the  to  field  on  the  Set  DELIMITERS  line,  enter  the  specific  delimiter 

if  Set  DELIMITERS  is  ON. 

Press  to  move  among  the  settings,  and  the  Spacebar  to  change  a  setting. 
When  you’re  satisfied  with  the  settings,  press  Ctrl-End. 

[SET  commands,  Language  Reference ] 

Search  path 

Use  this  option  to  enter  the  run-time  default  drive  and  search  path  for  the 
application  you’re  defining. 

In  the  Drive  field,  enter  the  name  of  the  drive  on  which  all  operations 
should  take  place  and  where  all  non-Applications  Generator  objects  (such 
as  reports,  forms,  and  database  files)  can  be  found  when  the  application  is 
run.  Pressing  Shift-FI  Pick  displays  a  list  from  which  you  can  choose  the 
drive  name. 

In  the  Search  path  field,  enter  the  directory  path  your  application  should 
take  to  find  objects  and  open  files,  such  as  database  files.  Press  Ctrl-End  to 
save  these  settings  and  return  to  the  Application  menu. 

[SET  DEFAULT  and  SET  PATH  commands,  Language  Reference ] 

View/database  and  index 

This  option  allows  you  to  change  the  database  file  or  view,  index  files,  or 
index  order  assigned  to  this  application  when  it  was  created.  Other  objects 
associated  with  this  application  will  be  automatically  assigned  the  new  files 
or  order,  unless  they  have  been  saved  with  other  assignments. 

The  names  of  the  currently  assigned  database  file  or  view,  index  files,  and 
index  order  for  this  application  appear  in  a  dialog  box  when  you  choose  this 
option.  If  you  don't  want  to  make  changes  to  these  assignments,  press  Esc  to 
return  to  the  Application  menu.  If  you  do  want  to  make  changes,  enter  the 
information  in  the  three  fields  on  this  dialog  box. 

In  the  Database/view  field,  type  in  a  different  database  file  or  view  for  the 
application  or  press  Shift-FI  Pick  to  choose  from  a  displayed  list  of  filenames 
in  the  current  catalog  or  directory.  Choosing  <  create  >  will  take  you  to  the 
design  screen  where  you  can  specify  a  new  database  file. 

In  the  Set  INDEX  to  field,  enter  the  new  index  or  indexes  by  typing  the  file¬ 
names  (.mdx  or  .ndx)  or  by  pressing  Shift-FI  Pick  to  choose  from  a  displayed 
list  of  indexes  in  the  current  catalog  or  directory. 
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NOTE 

You  can  choose  multiple  index  files  from  a  list  by  selecting  a  filename 
and  pressing  «-*,  selecting  another  filename  and  pressing  *-J,  and  so 
forth,  until  you've  selected  all  the  desired  index  filenames.  To  change 
your  mind  about  a  particular  index  file,  select  it  and  press  «— *  again. 
To  save  the  choices  and  exit  the  list,  press  Ctrl-End. 


In  the  ORDER  field,  enter  the  index  order  or  the  name  of  a  new  controlling 
index  if  it  differs  from  the-  one  assigned  to  the  application  object.  An  entry  in 
this  field  is  not  required.  [SET  ORDER  TO  command,  Language  Reference ] 

Press  Ctrl-End  to  save  your  changes  and  return  to  the  Application  menu. 

These  assignments  serve  as  the  defaults  for  your  application.  They  affect  each 
object  (the  menus,  lists,  and  batch  processes)  associated  with  this  applica¬ 
tion,  unless  the  objects  were  saved  with  their  own  assignments.  You  can  eas¬ 
ily  override  the  assignments  for  a  particular  object  or  item  by  choosing  the 
Override  assigned  database  or  view  option  from  any  of  the  other  object 
menus  and  the  Item  menu. 

Generate  quick  application 

Choosing  this  option  allows  you  to  create  a  simple,  single-menu  (pop-up) 
application  so  users  can  append,  edit,  browse,  and  pack  a  database  file.  If 
you  specify  an  index  file,  the  menu  will  also  include  an  option  to  reindex.  If 
you  specify  a  report  or  label  format,  the  menu  will  include  options  to  print 
one  or  both  of  these.  The  quick  application  uses  the  display  options  specified 
in  the  Preset  menu. 

The  Database  file  field  displays  the  database  file  you  specified  when  you 
entered  the  Applications  Generator.  To  change  it,  type  the  name  of  the  data¬ 
base  file,  or  press  Shift-FI  Pick  to  choose  one  from  the  displayed  list.  Choos¬ 
ing  <  create  >  takes  you  to  the  design  screen  where  you  can  specify  a  new 
database  file.  An  entry  in  this  field  is  required. 

In  the  Screen  format  file  field,  enter  the  name  of  the  screen  format  for 
this  quick  application  by  typing  it  or  by  pressing  Shift-FI  Pick.  Choosing 

<  create  >  takes  you  to  the  design  screen  where  you  can  specify  a  new 
screen  format  file.  No  entry  in  this  field  means  your  application  will  use 
the  default  screen  for  record  editing. 

In  the  Report  format  file  field,  enter  the  name  of  the  report  form  you  want 
for  this  quick  application  by  typing  it  or  by  pressing  Shift-FI  Pick.  Choosing 

<  create  >  takes  you  to  the  design  screen  where  you  can  specify  a  new 
report  format  file.  No  entry  in  this  field  means  the  Print  Report  item  will 
not  be  included  on  the  menu. 

In  the  Label  format  file  field,  enter  the  name  of  the  label  format  you  want 
for  this  quick  application  by  typing  it  or  by  pressing  Shift-FI  Pick.  Choosing 

<  create  >  takes  you  to  the  design  screen  where  you  can  specify  a  new 
label  format  file.  No  entry  in  this  field  means  the  Mailing  Labels  item  will 
not  be  included  on  the  menu. 
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In  the  Set  INDEX  to  field,  enter  the  name  of  the  index  file  if  it  differs  from 
the  one  you  specified  for  the  application  object.  Enter  the  index  name  by 
either  typing  it  or  pressing  Shift-FI  Pick.  An  entry  in  this  field  is  not 
required.  No  entry  in  this  field  means  the  Reindex  Database  item  will 
not  be  included  on  the  menu. 


NOTE 


You  can  choose  multiple  index  files  by  selecting  a  filename  and  press- 
ing  «-*,  selecting  another  filename  and  pressing  «-*,  and  so  forth,  until 
you've  selected  all  the  desired  index  filenames.  To  changeyour  mind 
about  a  selection,  press  again.  To  save  the  choices  and  exit  the  list, 
press  Ctrt-End. 

In  the  ORDER  field,  enter  the  index  order  or  the  name  of  the  new  control¬ 
ling  index  if  it  differs  from  what  you  specified  for  the  application  object.  An 
entry  in  this  field  is  not  required.  [SET  ORDER  TO  command,  Language 
Reference ] 

The  Application  author  field  displays  the  name  specified  with  the  Sign-on 
defaults  option  in  the  Preset  menu.  Change  it  by  typing  in  a  new  name.  This 
information  appears  as  a  comment  in  the  code  and  documentation  that  the 
Applications  Generator  creates. 

In  the  Application  menu  heading  field,  enter  the  heading  to  display  on  the 
menu  created  by  the  Applications  Generator.  If  you  don’t  specify  a  menu 
heading,  the  name  of  the  application  will  be  used.  Don’t  include  double 
quotation  marks  in  this  field. 

Press  Ctri-End  to  save  this  information.  You’re  asked  if  you  want  to  generate 
the  quick  application.  Select  No  or  accept  the  default,  Yes,  and  press  «-*.  If 
you  choose  Yes,  the  :ode  is  immediately  generated.  If  you  choose  No,  you 
return  to  the  Application  menu. 


NOTE 


The  Applications  Generator  uses  the  Quickapp.gen  template  to 
create  the  code  for  this  type  of  application.  If  you  choose  No  from 
the  confirmation  box,  you  can  generate  the  code  later  by  entering 
QUICKAPP.GEN  in  the  box  that  displays  when  you  choose  Select 
template  from  the  Generate  menu. 


Menu 


Urlte  help  text 
Modify  display  options 
Embed  code 

Attach  pull-doun  menus 


This  menu  appears  on  the  Applica¬ 
tions  Generator  menu  bar  when  the 
current  object  is  either  a  Horizon¬ 
tal  bar  menu  or  a  Pop-up  menu 


object. 


Put  auay  current  menu 


Clear  uork  surface 
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The  actual  options  on  the  menu  associated  with  Menu  vary  slightly  depend¬ 
ing  on  the  type  of  menu  you  chose.  If  the  current  object  is  a  horizontal  bar 
menu,  there’s  an  additional  option  in  Menu.  This  option  is  described  next. 
Refer  to  the  "Object  Menus”  section  for  a  description  of  the  other  options, 
which  are  common  to  all  object  menus. 


Attach  pull-down  menus 

This  option  appears  only  when  a  horizontal  bar  menu  object  is  the  current 
object.  It  allows  you  to  s'pfecify  whether  menus  (or  lists)  associated  with  hori¬ 
zontal  bar  menu  items  pull  down  automatically  as  the  user  positions  the  cur¬ 
sor  on  each  item. 

After  choosing  this  option,  accept  the  default,  No,  or  choose  Yes  in  response 
to  the  question  Pull  down  associated  menus... .  If  you  answer  Yes,  associ¬ 
ated  pull-down  menus  will  display  when  a  user  positions  the  cursor  on  a 
horizontal  bar  menu  item.  If  you  answer  No,  the  user  must  press  ♦-*  on  a 
horizontal  bar  menu  item  to  display  the  associated  menu. 


NOTE 

When  considering  this  option,  keep  in  mind  the  rules  of  inheritance. 

If  the  pull-down  menus  you  want  to  display  automatically  have  attri¬ 
butes  different  from  the  attributes  of  the  horizontal  bar  menu,  the  pull¬ 
down  attributes  will  be  overridden  by  those  of  the  horizontal  bar 
menu.  (See  “About  Inheritance”  near  the  beginning  of  this  tab 
section.) 


Make  your  decision  by  positioning  the  highlight  on  Yes  or  No  and  pressing 
«-J.  Either  selection  returns  you  to  Menu. 


NOTE 

You  associate  menus  ( either  pull-down  or  stand-alone)  or  lists  with  a 
particular  menu  item  when  you  assign  an  action  to  the  item.  Specifi¬ 
cally,  you  use  the  Open  a  menu  action  in  the  Item  menu  to  associate 
menus  or  lists  with  menu  items.  Refer  to  the  “Item"  section  for  more 
information  on  the  Open  a  menu  action. 


List 


Ur It*  help  text 
»  Modify  display  options 
►  Enbod  code 


Identify  files  In  list 


Save  current  list 
Put  auay  current  list 


Clear  uork  surface 

■H^SS 


This  menu  appears  on  the  Applica¬ 
tions  Generator  menu  bar  when 
the  current  object  is  a  Files  list, 
Structure  list,  or  Values  list. 
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The  actual  options  on  the  List  menu  vary  slightly,  depending  on  the  type  of 
the  current  list.  The  options  specific  to  the  List  menu  are  described  next. 
Refer  to  the  "Object  Menus"  section  for  a  description  of  the  other  options, 
which  are  common  to  all  object  menus. 

Identify  files  in  list 

This  option  appears  on  the  List  menu  when  a  Files  list  object  is  the  current 
object. 

After  choosing  this  option,  ‘enter  the  files  that  you  want  to  appear  in  the  cur¬ 
rent  Files  list  object  by  using  the  asterisk  (*)  or  question  mark  (?)  wildcards 
to  enter  a  group  of  filenames.  For  example,  enter  *.dbf  to  include  all  data¬ 
base  files  in  the  current  directory,  or  *.?dx  to  include  both  .mdx  and  .ndx 
files. 

If  you  don’t  enter  filenames,  the  Applications  Generator  will  use  all  files  in 
the  directory  to  create  the  Files  list. 

When  you  finish,  press  Ctrl-End  to  save  the  filename  assignment  and  return 
to  List. 

Identify  fields  in  list 

This  option  displays  on  the  List  menu  if  a  Structure  list  object  is  the  current 
object. 

After  choosing  this  option,  you  can  either  type  the  names  of  the  fields  that 
you  want  to  appear  in  the  current  Structure  list,  or  press  Shift-FI  Pick.  When 
typing,  enter  the  field  names  from  the  database  file  or  view  assigned  to  this 
Structure  list  object,  separating  each  name  with  a  comma.  If  you  enter  no 
field  names,  the  Appli  :ations  Generator  will  use  ail  fields  in  the  currently 
assigned  database  file  or  view. 

The  list  that  displays  if  you  press  Shift-FI  Pick  contains  all  the  fields  in  the 
assigned  database  file.  To  add  a  field,  select  it  and  press  «-*.  To  change  your 
mind  about  including  a  field,  select  it  and  press  *->  again.  To  find  a  field  in 
a  very  long  list,  type  the  first  letter  or  few  letters  of  the  field  name  if  you 
know  it.  The  first  field  that  matches  these  letters  will  be  highlighted. 


the  list. 


NOTE 

If  the  Structure  list  is  automatically  attached  as  a  pull-down  menu  to 
a  horizontal  bar  menu  item,  all  fields  in  the  file  will  be  displayed  in 


Press  Ctrl-End  to  save  the  field  name  assignments  and  return  to  List. 

Identify  field  values  in  list 

This  option  displays  on  the  List  menu  if  a  Values  list  object  is  the  current 
object. 
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After  choosing  this  option,  you’re  prompted  to  enter  the  field  name  from 
which  you  want  values  to  be  listed  in  the  current  Values  list  object.  You  must 
enter  a  field  name  defined  in  the  structure  for  the  current  database  file  or 
view. 

You  can  either  type  in  the  field  name  or  press  Shift-FI  Pick  to  choose  one 
from  a  list  of  the  fields  in  the  database  file  or  view  assigned  to  this  Values 
list. 

To  find  a  field  in  a  long  list,  type  the  first  letter  or  few  letters  of  the  field 
name.  This  technique  highlights  the  first  field  in  the  list  that  matches  these 
letters.  It's  useful  if  the"  displayed  list  is  very  long  and  you’re  not  sure  of  the 
exact  field  name.  To  change  your  mind  about  the  field,  select  it  and  press 
again. 

Press  Ctrt-End  to  save  the  field  name  assignment  and  return  to  List. 


Batch 


Override  assigned  database  or  view 
Embed  code 


Save  current  batch  process 
Put  auay  current  batch  process 


Clear  uork  surface 


This  menu  appears  on  the  Applica¬ 
tions  Generator  menu  bar  when  a 
batch  process  object  is  the  current 
object. 


All  the  options  on  this  menu  are  the  same  as  the  common  options  described 
in  the  “Object  Menus’’  section.  Refer  to  that  section  for  further  information 
on  these  options. 


Item 


This  menu  is  available  whenever  a 
menu,  list,  or  batch  process  object 
is  the  current  object.  After  you’ve 
created  a  list  or  entered  at  least 
one  item  for  a  menu  or  batch 
process,  you  can  specify  an  action 
that  will  be  performed  when  the 
user  selects  the  item.  You  can  also 
assign  attributes  to  that  item.  For 
example,  you  can  write  help  text 
or  position  the  record  pointer 
before  the  action  starts. 

For  menu  objects,  you’ll  assign  an  action  to  each  item  on  the  menu. 

For  list  objects,  you’ll  assign  one  action  to  be  performed  whenever  an  item 
is  chosen  from  the  list. 

For  batch  process  objects,  you’ll  assign  an  action  to  each  line  in  the  batch 
process  object. 


,  ►  Change  action 

Override  assigned  database  or  vleu 
►  Embed  code 

Bypass  item  on  condition 
Position  record  pointer 
Reassign  index  order 
Define  logical  ulndou 
Urlte  help  text 

j  Resign  message  line  prompt 
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Before  beginning,  select  the  item  (or  the  list)  to  which  you  wish  to  assign  an 
action. 

To  specify  actions  to  more  than  one  item  in  an  object,  use  PgUp  and  PgDn 
to  cycle  through  the  items  while  in  the  Item  menu.  The  status  bar  indicates 
which  item  you’re  specifying.  This  method  is  much  faster  than  backing  out  of 
dialog  boxes  and  submenus,  choosing  another  item,  and  returning  to  Item. 

For  example,  if  you  want  to  assign  the  Open  a  menu  action  to  every  item  in 
a  menu,  choose  that  action,  assign  the  menu  type  and  name  to  the  first  item, 
and  then  press  PgDn  to  select  the  next  item  in  the  menu.  Then,  assign  a 
menu  name  and  type  for  that  item,  and  so  forth,  until  all  the  items  are 
assigned  that  action. 

Descriptions  of  the  options  on  this  menu  follow. 


Show  item  information 

After  choosing  this  option,  the  dialog  box  shown  in  Figure  4-7  appears. 


Current  Information  for  hlghllghtad  lt»M 


Figure  4-7  Show  item  information  dialog  box 


This  box  displays  the  action  assigned  to  the  current  item. 

When  you’ve  reviewed  the  information,  press  «-*  or  Esc  to  leave  the  dialog 
box.  To  change  this  information,  go  to  an  option  on  the  Item  menu.  The 
descriptions  of  the  fields  in  this  dialog  box  follow. 

Object 

This  field  displays  the  name  of  the  object  that  contains  the  item  you  selected. 

Item 

This  field  displays  the  item  you  selected  on  the  work  surface. 
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Current  database/view  <  filename  >  using  index  <  filename  > 

The  field  displays  the  currently  assigned  database  file  or  view,  and  the  index 
for  the  item  if  there  is  one.  If  you  haven’t  specifically  assigned  a  database 
file  or  view,  or  index,  for  the  item,  this  field  displays  the  assignments  for  the 
application  object. 

This  field  helps  you  remember  the  database  file  or  view,  and  index,  used 
when  the  user  chooses  this  item. 

This  item  will 

This  field  displays  the  action  you  specified  for  this  item  with  the  Change 
action  option  in  the  Item  menu.  The  default  action  is  Text  (no  action). 

To  leave  this  dialog  box,  accept  OK  by  pressing  «-*. 


NOTE 

You  can  use  PgUp  and  PgDn  to  review  quickly  the  item  information 
for  each  item  in  a  menu  or  batch  process  object. 


Change  action 

This  option  allows  you  to  specify  an  action  to  be  associated  with  the  current 
item.  If  you  don’t  specify  an  action,  Text  (no  action)  will  be  automatically 
assigned  to  the  item  or  list. 

After  choosing  this  option,  you  see  the  menu  shown  in  Figure  4-8. 


Figure  4-8  Item  actions  menu 
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Many  options  on  this  menu  relate  to  dBASE  commands,  as  shown  in  the 
right  margin  next  to  the  opiion.  To  fill  in  the  dialog  box  that  displays  when 
you  choose  an  option,  you’ll  need  some  knowledge  of  dBASE  syntax  —  that 
is,  the  requirements  for  writing  commands  in  dBASE.  The  fields  in  the  dialog 
box  provide  the  command,  but  you  must  enter  the  scope,  expression,  and 
condition. 


rext  (no  action) 


Print  Labels 
Exit 


Figure  4-9  Text  (no  action) 

In  this  example,  the  first  four  lines,  including  the  dividing  line,  are  defined 
as  text.  Because  Text  (no  action)  is  the  default,  you  don’t  need  to  assign  this 
action  to  informational  lines  such  as  those  in  Figure  4-9.  Rather,  the  Text 
(no  action)  option  is  useful  when  you  want  to  change  an  action  item  to  a 
non-action  item. 

After  choosing  this  option,  press  at  the  OK  prompt. 

Open  a  menu 

This  action  opens  a  menu  or  a  list.  Use  it  to  create  an  application  with  sub¬ 
menus,  such  as  pull-down  menus.  For  example,  specify  a  bar  menu  item  that 
you  want  to  associate  with  a  pop-up  (pull-down)  menu. 

After  choosing  this  action,  a  dialog  box  appears  in  which  you  specify  the 
menu  type  and  name  of  the  menu  or  list. 

In  the  Menu  type  field,  press  the  Spacebar  to  make  your  choice.  Then 
press  «->. 
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In  the  Menu  name  field,  type  the  name  of  the  menu  or  list,  or  press 
Shift-FI  Pick  to  see  the  menus  or  lists  from  the  current  directory.  Only  saved 
menus  or  lists  appear,  including  any  saved  menus  or  lists  on  the  work  sur¬ 
face.  The  menus  or  lists  that  appear  are  of  the  same  type  you  specified  in  the 
first  field. 

If  you  haven’t  yet  created  the  menu  or  list  you’re  specifying  in  this  option, 
you  can  name  it  now  and  create  it  later.  Or,  you  can  go  to  the  Design  menu, 
create  the  menu  or  list,  and  return  to  the  Item  menu  to  assign  the  action. 


Browse  (add,  deleter,  edit) 

Choose  this  action  when  you  want  to  specify  an  item  that  allows  your  users 
to  add,  delete,  or  edit  a  database  file  (as  done  with  the  dBASE  command 
BROWSE).  The  BROWSE  command  presents  the  records  of  a  database  file 
in  a  table  so  users  can  view  more  than  one  record  at  a  time.  [BROWSE  com¬ 
mand,  Language  Reference ] 

After  choosing  this  action,  you’re  prompted  to  enter  information  about  the 
action.  Descriptions  of  the  fields  follow. 

FIELDS 

Enter  the  names  of  the  fields  to  include  in  the  Browse  action.  You  can  type 
them  in,  separating  each  field  with  a  comma,  or  you  can  use  Shift-FI  Pick  to 
choose  them  from  a  displayed  list.  You  can  enter  up  to  68  characters  in  this 
field.  If  you  don't  enter  the  field  names,  the  user  will  see  all  the  fields  in  the 
assigned  database  file  or  view. 

The  list  that  displays  when  you  press  Shift-FI  Pick  contains  all  the  fields  in 
the  assigned  database  file.  To  add  a  field,  select  it  and  press  «-*.  To  change 
your  mind  about  including  a  field,  select  it  and  press  again.  To  find  a 
field  in  a  very  long  list,  type  the  first  letter  or  a  few  letters  of  the  field  name 
if  you  know  it.  The  first  field  that  matches  these  letters  will  be  highlighted. 
[BROWSE  command,  FIELDS  clause,  Language  Reference ] 


FILTER 

Specify  the  query  file  and/or  the  filter  condition  to  use  with  Browse.  File¬ 
names  must  be  preceded  by  the  FILE  keyword.  The  Applications  Generator 
assumes  these  are  query  files,  unless  you  specify  otherwise.  [SET  FILTER  TO 
command,  Language  Reference ] 

Fields  to  LOCK  onscreen 

Specify  the  number  of  contiguous  fields  that  remain  on  the  left  side  of  the 
screen  when  the  user  moves  from  column  to  column.  The  default  is  0,  mean¬ 
ing  that  no  fields  are  locked.  An  entry  in  this  field  is  optional.  [BROWSE  com¬ 
mand,  LOCK  option,  Language  Reference ] 
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FREEZE  edit  for  field 

Specify  a  field  to  which  the  cursor  is  confined  when  the  application  is  run. 
Type  in  the  field  name,  or  press  Shift-FI  Pick  to  choose  from  a  displayed  list. 
If  you  don’t  specify  a  field,  all  previously  frozen  fields  will  be  unfrozen  and 
the  cursor  will  no  longer  be  confined  to  one  field.  An  entry  in  this  field  is 
optional.  [BROWSE  command,  FREEZE  clause,  Language  Reference ] 

Maximum  column  WIDTH 

Specify  the  maximum  column  width  (number  of  characters)  in  the  Browse 
table.  No  column  will  be  wider  than  the  width  specified,  regardless  of  the 
individual  field  widths  assigned  when  the  database  file  was  created.  An  entry 
in  this  field  is  optional.  [BROWSE  command,  WIDTH  command,  Language 
Reference ] 

FORMAT  file 

Specify  the  name  of  the  format  (.fmt)  file  to  be  used  when  users  choose 
this  item  to  display  and  validate  data.  Type  a  name  or  press  Shift-FI  Pick 
to  choose  a  .fmt  file  from  the  current  catalog  or  directory.  Choosing 
<  create  >  takes  you  to  the  design  screen  where  you  can  specify  a  for¬ 
mat  file.  If  you  don’t  specify  an  .fmt  file,  the  standard  Edit  format  will  be 
used.  [SET  FORMAT  TO  command,  Language  Reference ] 

Allow  record  ADD 

Specify  whether  to  allow  users  to  append  records  to  the  end  of  the  database 
file.  To  change  the  default,  YES,  press  the  Spacebar.  [BROWSE  command, 
NOAPPEND  option,  L  inguage  Reference ] 

Allow  record  EDIT 

Specify  whether  to  allow  users  to  edit  records  as  they  browse  a  table  of 
records.  To  change  the  default,  YES,  press  the  Spacebar.  [BROWSE  com¬ 
mand,  NOEDIT  option,  Language  Reference ] 

Allow  record  DELETE 

Specify  whether  to  allow  users  to  delete  records  from  the  database  file. 

To  change  the  default,  YES,  press  the  Spacebar.  [BROWSE  command, 
NODELETE  option,  Language  Reference ] 

KEEP  image  on  exit 

Specify  whether  to  keep  the  image  of  the  table  on  the  screen  after  the  user 
ends  the  Browse  session.  To  change  the  default,  NO,  press  the  Spacebar. 
[BROWSE  command,  NOCLEAR  option,  Language  Reference ] 

Display  Browse  MENU 

Specify  whether  to  display  the  default  Browse  menus.  To  change  the  default, 
YES,  press  the  Spacebar.  [BROWSE  command,  NOMENU  option,  Language 
Reference] 
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Use  PREVIOUS  Browse  table 

Specify  whether  to  use  the  previously  defined  Browse  table  rather  than 
creating  a  new  structure.  To  change  the  default,  NO,  press  the  Spacebar. 
[BROWSE  command,  NOINIT  option,  Language  Reference] 


FOLLOW  record  after  update 

Specify  whether  to  reposition  a  record  according  to  its  new  key  value  in  the 
index.  To  change  the  default,  YES,  press  the  Spacebar.  [BROWSE  command, 
NOFOLLOW  option.  Language  Reference ] 


COMPRESS  display 

Specify  whether  to  compress  the  format  of  the  Browse  table  to  allow  more 
lines  of  data  on  the  screen.  To  change  the  default,  NO,  press  the  Spacebar. 
[BROWSE  command,  COMPRESS  option,  Language  Reference] 

Press  Ctrl-End  to  save  this  information. 

Edit  form  (add,  delete,  edit) 

This  action  allows  users  to  add,  delete,  or  edit  a  database  file,  as  done  with 
the  dBASE  command  EDIT.  The  EDIT  command  displays  the  records  of  a 
database  file  one  record  at  a  time.  [EDIT  command,  Language  Reference] 

After  choosing  this  action,  you’re  prompted  to  enter  information  about  the 
action.  Descriptions  of  the  fields  follow. 

FORMAT  file 


Specify  the  name  of  the  format  users  will  see  when  they  choose  this  item. 
Type  a  name  or  press  Shift-FI  Pick  to  choose  a  .fmt  file  from  the  current  cat¬ 
alog  or  directory.  Choosing  <  create  >  takes  you  to  the  design  screen  where 
you  can  specify  a  format  file.  If  you  don’t  specify  an  .fmt  file,  the  standard 
Edit  format  will  be  used.  [SET  FORMAT  TO  command,  Language  Reference] 


Mode 

Change  the  default  editing  mode  from  APPEND  to  EDIT  by  pressing  the 

Spacebar. 

FIELDS 

Enter  the  names  of  the  fields  to  include  in  the  Edit  action.  You  can  type 
them  in,  separating  each  field  with  a  comma,  or  you  can  use  Shift-FI  Pick 
to  choose  them  from  a  displayed  list.  If  you  don’t  enter  the  field  names,  the 
user  will  see  all  of  the  fields  in  the  assigned  database  file  or  view. 

The  list  that  displays  if  you  press  Shift-FI  Pick  contains  all  the  fields  in  the 
assigned  database  file,  to  add  a  field,  select  it  and  press  «-*.  To  change  your 
mind  about  including  a  field,  select  it  and^press  4-1  again.  To  find  a  field  in 
a  very  long  list,  type  the  first  letter  or  few  letters  of  the  field  name  if  you 
know  it.  The  first  field  that  matches  these  letters  will  be  highlighted.  [EDIT 
command,  FIELDS  option,  Language  Reference] 
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FILTER 

Specify  the  query  file  and/or  the  filter  condition  to  use.  The  filename  must 
be  preceded  by  the  FILE  keyword.  The  Applications  Generator  assumes  these 
are  query  files,  unless  you  specify  otherwise.  [SET  FILTER  TO  command, 
Language  Reference ] 

SCOPE,  FOR,  WHILE 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  available  for  editing.  [SCOPE  clause,  Language 
Reference ] 

In  the  FOR  field,  enter  a  condition  that  must  be  met  for  a  record  to  be 
edited.  [FOR  clause,  Language  Reference] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  editing  records 
should  stop.  [WHILE  clause,  Language  Reference] 

Allow  record  ADD 

Specify  whether  to  allow  users  to  append  records  to  the  database  file.  To 
change  the  default,  YES,  press  the  Spacebar.  [EDIT  command,  NOAPPEND 
option,  Language  Reference] 

Allow  record  EDIT 

Specify  whether  to  allow  users  to  update  records.  To  change  the  default, 
YES,  press  the  Spacebar.  [EDIT  command,  NOEDIT  option,  Language 
Reference] 

Allow  record  DELETE 

Specify  whether  to  allow  users  to  delete  records  from  the  database  file.  To 
change  the  default,  YES,  press  the  Spacebar.  [EDIT  command,  NODELETE 
option,  Language  Reference] 

KEEP  image  on  exit 

Specify  whether  to  keep  the  table  image  on  screen  after  the  user  ends  a 
Browse  editing  session  initiated  from  Edit.  To  change  the  default,  YES.  press 
the  Spacebar.  [EDIT  command,  NOCLEAR  option,  Language  Reference] 

Display  EDIT  menu 

Specify  whether  to  display  the  default  Edit  menu  (the  menu  that  appears 
when  the  user  presses  F10  Menus).  To  change  the  default,  YES,  press  the 
Spacebar.  [EDIT  command,  NOMENU  option,  Language  Reference] 

Use  PREVIOUS  Edit  form 

Specify  whether  to  use  the  previously  defined  Edit  table  rather  than  creating 
a  new  table.  [EDIT  command,  NOINIT  option,  Language  Reference] 
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FOLLOW  record  after  update 

Specify  whether  to  reposition  a  record  according  to  its  new  key  value  in  the 
index.  To  change  the  default,  YES,  press  the  Spacebar.  [EDIT  command, 
NOFOLLOW  option,  Language  Reference ] 

Press  Ctrt-End  to  save  this  information. 


Display  or  print 

This  action  prints  or  displays  information,  such  as  reports  and  labels. 

After  choosing  this  action,  a  menu  displays  from  which  you  can  select 
whether  to  print  reports  or  labels  or  to  display  information.  This  menu 
is  described  in  the  following  sections. 

Report 

This  action  prints  a  report.  After  selecting  it,  you  see  a  dialog  box. 
Descriptions  of  the  fields  in  this  box  follow. 

In  the  FORM  name  field,  enter  the  name  of  the  report  form  to  print  when 
users  select  this  item.  You  can  type  in  the  name  or  press  Shift-FI  Pick 
to  select  a  report  form  from  the  current  catalog  or  directory.  Choosing 
<  create  >  takes  you  to  the  design  screen  where  you  can  specify  a  report 
form.  An  entry  in  this  field  is  required. 


NOTE 

To  allow  users  to  determine  what  report  they  want  to  print,  see  the 
“Giving  the  User  More  Control"  section  earlier  in  this  tab  section. 


In  the  HEADING  field,  you  can  enter  an  extra  heading  to  print  on  the  first 
line  of  each  page  of  the  report.  Double  quotation  marks  may  not  be  used. 

In  the  Report  format  field,  specify  whether  to  print  detail  or  summary 
lines.  Choose  between  FULL  DETAIL  or  SUMMARY  ONLY  by  pressing 
the  Spacebar.  Choosing  SUMMARY  ONLY  means  the  report  will  print  with 
subtotals  and  totals  but  no  detail  lines. 

In  the  Heading  format  field,  specify  whether  the  report  heading  should 
include  the  date  and  page  number,  or  whether  it  should  be  plain.  Choose 
between  PLAIN  and  INCLUDE  DATE  AND  PAGE  by  pressing  the  Spacebar. 

In  the  Before  printing  field,  specify  whether  to  eject  a  page  before  printing. 
Choose  between  SKIP  TO  NEW  PAGE  and  DO  NOT  EJECT  by  pressing  the 

Spacebar. 

In  the  Send  output  to  field,  specify  where  the  report  output  should  be  sent. 
The  choices  are  PRINTER.  DISK  FILE,  SCREEN,  and  ASK  AT  RUN 
TIME.  The  last  choice  gives  users  the  previous  three  choices  in  a  pop-up 
menu  (you  don’t  need  to  define  this  menu).  Press  the  Spacebar  to  cycle 
through  the  choices. 

In  the  FILTER  field,  specify  the  query  file  and/or  the  filter  condition  to  use 
in  the  report.  Filenames  must  be  preceded  by  the  FILE  keyword.  The  Appli¬ 
cations  Generator  assumes  these  are  query  files  unless  you  specify  otherwise. 
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In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  to  be  included  in  the  report.  [SCOPE 
clause,  Language  Reference ] 

In  the  FOR  field,  enter  a  condition  that  must  be  met  for  the  record  to  be 
included  in  the  report.  [FOR  clause,  Language  Reference ] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  the  inclusion  of 
records  in  the  report  should. stop.  [WHILE  clause,  Language  Reference ] 

Press  Ctrl-End  to  save  this  information. 

[CREATE  REPORT  command,  Language  Reference ] 


Labels 


This  action  prints  labels.  After  choosing  it,  a  dialog  box  displays.  Descriptions 
of  the  fields  in  this  box  follow. 

In  the  FORM  name  field,  enter  the  name  of  the  label  form  to  print  when 
users  select  this  item.  You  can  type  in  the  name  or  press  Shift-FI  Pick 
to  select  a  label  form  from  the  current  catalog  or  directory.  Choosing 
<  create  >  takes  you  to  the  design  screen  where  you  can  specify  a  labels 
form.  An  entry  in  this  field  is  required. 


NOTE 


To  allow  users  to  determine  what  label  form  they  wish  to  use,  see 
" Giving  the  User  More  Control”  earlier  in  this  tab  section. 

In  the  Send  output  to  field,  specify  where  the  label  output  should  be  sent.' 
The  choices  are  PRINTER,  DISK  FILE,  SCREEN,  and  ASK  AT  RUN 
TIME.  The  last  choice  gives  users  the  previous  three  choices  in  a  pop-up 
menu  (you  don’t  need  to  define  this  menu).  Press  the  Spacebar  to  cycle 
through  the  choices. 

In  the  Print  SAMPLE  field,  specify  whether  the  item  selected  by  the  user 
displays  test  labels.  You  choose  between  YES  and  NO  by  pressing  the 

Spacebar. 

In  the  FILTER  field,  specify  the  query  file  and/or  the  filter  condition  to  use 
for  the  labels.  Filenames  must  be  preceded  by  the  FILE  keyword.  The  Appli¬ 
cations  Generator  assumes  these  are  query  files  unless  you  specify  otherwise. 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  to  be  printed  as  a  label.  [SCOPE  clause, 
Language  Reference] 

In  the  FOR  field,  enter  a  condition  that  must  be  met  for  the  record  to  be 
printed  as  a  label.  [FOR  clause,  Language  Reference] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  printing  should 
stop.  [WHILE  clause,  Language  Reference] 

Press  Ctrl-End  to  save  this  information. 

[CREATE  LABEL  command,  Language  Reference] 
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Display/list 


Choose  this  action  when  you  want  an  item  to  display  the  records  in  a  data¬ 
base  or  view.  After  choosing  this  action,  a  dialog  box  appears.  Descriptions 
of  the  fields  follow. 

In  the  PAUSE  at  full  page/screen  field,  specify  whether  to  pause  the  display 
after  20  lines.  Press  the  Spacebar  to  choose  between  YES  and  NO.  Choosing 
YES  pauses  the  display  after  20  lines,  which  is  how  the  dBASE  command 
DISPLAY  operates.  Choosing  NO  means  all  records  will  display  without  paus¬ 
ing,  which  is  how  the  dBASE  command  LIST  operates.  (If  the  display 
appears  in  a  window,  the  number  of  lines  will  vary  with  the  size  of  the 
window.) 

In  the  Send  output  to  field,  specify  where  the  display  or  list  output  should 
be  sent.  The  choices  are  PRINTER,  DISK  FILE,  SCREEN,  and  ASK  AT 
RUN  TIME.  The  latter  choice  gives  your  users  the  previous  three  choices 
in  a  pop-up  menu  (you  don’t  need  to  define  this  menu).  Press  the  Spacebar 
to  cycle  through  the  choices. 

In  the  Include  RECORD  NUMBERS  field,  specify  whether  the  display  or  list 
should  include  the  record  numbers.  Choose  between  YES  and  NO  by  press¬ 
ing  the  Spacebar. 

In  the  FIELDS  field,  you  specify  the  fields  to  include  in  the  display  or  list. 
You  can  type  them  in,  separating  each  field  with  a  comma,  or  you  can  use 
Shift-FI  Pick  to  choose  them  from  a  displayed  list.  If  you  don’t  enter  the  field 
names,  the  user  will  see  all  the  fields  in  the  assigned  database  file  or  view. 

The  list  that  displays  if  you  press  Shift-FI  Pick  contains  all  the  fields  in  the 
assigned  database  file.  To  add  a  field,  select  it  and  press  4-J.  To  change  your 
mind  about  including  a  field,  select  it  and  press  «->  again.  To  find  a  field  in 
a  very  long  list,  type  the  first  letter  or  few  letters  of  the  field  name  if  you 
know  it.  The  first  field  that  matches  these  letters  will  be  highlighted. 

In  the  FILTER  field,  specify  the  query  file  and/or  the  filter  condition  to  use 
for  the  display  or  list.  Filenames  must  be  preceded  by  the  FILE  keyword.  The 
Applications  Generator  assumes  these  sire  query  files  unless  you  specify 
otherwise. 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  to  be  included  in  the  display  or  list. 
[SCOPE  clause,  Language  Reference ] 

In  the  FOR  field,  enter  a  condition  that  must  be  met  for  the  record  to  be 
included  in  the  display  or  list.  [FOR  clause,  Language  Reference] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  inclusion  of 
records  in  the  display  or  list  should  stop.  [WHILE  clause,  Language 
Reference] 

Press  Ctrl-End  to  save  this  information. 

[DISPLAY  and  LIST  commands,  Language  Reference] 
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Perform  file  operation 

Choose  this  action  when  you  want  to  assign  a  file  operation  to  an  item.  For 
example,  you  can  have  a  batch  process  item  update,  sort,  or  reindex  a  data¬ 
base,  create  a  new  index,  or  import  or  export  a  foreign  file. 

After  choosing  this  action,  the  File  operations  submenu  displays.  The  actions 
on  this  menu  are  explained  in  the  following  sections. 


Figure  4-10  File  operations  menu 


File  copy 

This  action  copies  one  closed  file  to  another  file.  After  choosing  this  action, 
you're  asked  to  enter  the  name  of  the  file  to  copy  and  the  name  of  the  target 
file  that  receives  the  copy.  This  command  copies  files  in  blocks  of  512  bytes, 
so  you  can  copy  any  file  type,  even  .exe  files. 


NOTE 

To  allow  users  to  copy  files  of  their  choosing,  see  “Giving  the  User 
More  Control’’  earlier  in  this  tab  section. 


In  either  of  the  fields,  you  must  type  a  filename  or  press  Shift-FI  Pick  to 
select  one. 

Press  Ctrt-End  to  save  this  information. 

[COPY  FILE  command,  Language  Reference] 

Add  records  from  file 

This  action  adds  records  from  one  file  to  the  active  database  file. 


4-40 


REFERENCE 


JOBNAME.  No  Job  Name  PAGE:  41  SESS:  4  OUTPUT:  Tue  Jun  14  00:17:26  1988 
CLS:  manhat  GRP:  manhat  JOB:  manappgen  DIV:  agchap4 


NOTE 

To  allow  users  to  add  records  to  a  file  of  their  choosing  see  “Giving 
the  User  More  Control ”  earlier  in  this  tab  section. 


After  choosing  this  action,  enter  information  in  the  following  fields. 

In  the  Add  records  FROM  file/array  field,  enter  the  name  of  the  file  or 
array  from  which  the  records  should  be  appended.  Enter  the  filename  by 
typing  it  or  by  pressing  Shift-FI  Pick  to  select  the  name  from  the  current 
catalog  or  directory. 

In  the  of  type  field,  choose  the  type  of  file  from  which  the  records  will  be 
appended.  You  choose  among  DBF,  dBASE  II,  FW2,  RPD,  DELIMITED 
ARRAY,  SDF,  DIF,  SYLK,  WKS,  and  by  pressing  the  Spacebar 

In  the  DELIMITER  field,  if  the  of  type  field  above  is  DELIMITED,  enter 
the  delimiter  used  in  the  file  from  which  the  records  will  be  copied.  If  the 
delimiter  is  double  quotation  marks,  you  can  leave  this  field  blank. 

In  the  FOR  field,  enter  the  condition  that  must  be  met  for  a  record  to  be 
added  to  the  target  file.  [FOR  clause,  Language  Reference] 

Press  Ctrl-End  to  save  this  information. 

[APPEND  FROM  command,  Language  Reference ] 

Copy  records  to  file 

This  action  copies  specific  fields  from  the  active  database  file  to  another 
file.  It  differs  from  the  File  copy  action  in  that  it  can  copy  specific  fields 
or  records,  not  just  the  whole  file.  This  action  overwrites  any  data  in  the 
target  file.  It  does  not  append  records. 


NOTE 

To  allow  users  to  copy  records  of  their  choosing  to  a  file,  see  “Giving 
the  User  More  Control"  earlier  in  this  tab  section. 


After  choosing  this  action,  enter  information  in  the  following  fields. 

In  the  Copy  records  TO  file/array  field,  enter  the  name  of  the  file  or  array 
to  which  the  records  should  be  copied.  Enter  the  filename  by  typing  it  or  bv 
pressing  Shift-FI  Pick  to  select  a  name  from  the  current  catalog  or  directory. 

In  the  of  type  field,  choose  the  type  of  file  to  which  the  records  will  be  cop¬ 
ied.  Choose  among  DBF,  dBASE  II,  FW2,  RPD,  DELIMITED,  ARRAY, 

SDF,  DIF,  SYLK,  and  WKS  by  pressing  the  Spacebar. 

In  the  DELIMITER  field,  if  the  of  type  field  above  is  DELIMITED,  enter 
the  delimiter  used  in  the  file  to  which  the  records  will  be  copied.  If  the  deli¬ 
miter  is  double  quotation  marks,  you  can  leave  this  field  blank. 

In  the  FIELDS  field,  specify  a  list  of  the  fields  to  include  in  the  target  file. 
You  can  type  them  in,  separating  each  field  with  a  comma,  or  you  can  use 
Shift-FI  Pick  to  choose  them  from  a  displayed  list.  If  you  don’t  enter  the  field 
names,  the  user  will  see  all  the  fields  in  the  assigned  database  file  or  view. 
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The  list  that  displays  when  you  press  Shift-FI  Pick  contains  all  the  fields  in 
the  assigned  database  file.  To  add  a  field,  select  it  and  press  «-J.  To  change 
your  mind  about  including  a  field,  select  it  and  press  +-1  again.  To  find  a  field 
in  a  very  long  list,  type  the  first  letter  or  few  letters  of  the  field  name  if  you 
know  it.  The  first  field  that  matches  these  letters  will  be  highlighted. 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  that  are  to  be  included  in  the  target 
file.  [SCOPE  clause,  Language  Reference] 

In  the  FOR  field,  enter  a  condition  that  must  be  met  for  the  records  to  be 
copied  to  the  target  file.  [FOR  clause,  Language  Reference] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  records  should  no 
longer  be  eligible  for  copying.  [WHILE  clause,  Language  Reference] 

Press  Ctii-End  to  save  this  information. 

[COPY  TO  command,  Language  Reference] 

Substitute  field  values 

This  action  performs  a  REPLACE  command  operation.  This  command  speci¬ 
fies  new  values  for  fields  in  a  database  file. 


NOTE 

To  allow  users  to  specify  field  values,  see  “Giving  the  User  More 
Control "  earlier  in  this  tab  section. 


After  choosing  this  action,  enter  information  in  the  following  fields: 

In  the  SCOPE  field,  enter  the  extent  or  number  of  records  in  a  file  that  are 
to  be  searched  [SCOPE  clause,  Language  Reference] 

In  the  FOR  field,  enter  a  condition  that  must  be  met.  [FOR  clause,  Language 
Reference] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  records  should  no 
longer  be  subject  to  the  REPLACE.  [WHILE  clause,  Language  Reference] 

Under  The  field  named,  enter  each  field  that  you  wish  to  replace  with  a  new 
value.  You  can  type  each  field  name,  or  you  can  use  Shift-FI  Pick  to  choose 
from  a  displayed  list.  Entries  in  the  first  line  are  required. 


In  each  with  this  value  field,  enter  the  new  value  (including  an  expression) 
for  the  corresponding  field. 

In  the  ADDITIVE  option  field,  specify  whether  the  substitute  value  should 
be  added  to  the  current  value  in  the  field  (for  memo  fields  only),  rather  than 
replacing  the  current  value.  To  change  the  default,  NO,  press  the  Spacebar. 
Press  Ctrl-End  to  save  this  information. 


[REPLACE  command,  Language  Reference] 
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Mark  records  for  deletion 

This  action  performs  a  DELETE  command  operation.  This  command  marks 
certain  records  for  deletion. 

After  choosing  this  action,  enter  information  in  the  following  fields. 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  that  are  to  be  marked  for  deletion. 
[SCOPE  clause,  Language  Reference ] 

In  the  FOR  field,  enter  a  condition  that  must  be  met.  [FOR  clause,  Language 
Reference ] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  records  should 
cease  being  marked  for  deletion.  [WHILE  clause,  Language  Reference ] 

Press  Ctii-End  to  save  this  information. 

[DELETE  command,  Language  Reference ] 

Unmark  records 

This  action  removes  the  mark  indicating  that  a  record  should  be  deleted. 


NOTE 

To  allow  users  to  unmark  records  of  their  choosing,  you  must  write 
the  dBASE  code  for  this  action  and  embed  it  with  an  item.  See  the 
description  of  the  Embed  code  option  later  in  this  tab  section. 


After  choosing  this  action,  enter  information  in  the  following  fields. 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  that  are  to  be  searched  for  recall. 
[SCOPE  clause,  Language  Reference ] 

In  the  FOR  field,  enter  a  condition  that  must  be  met.  [FOR  clause,  Language 
Reference ] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  records  should  no 
longer  be  subject  to  recall.  [WHILE  clause,  Language  Reference ] 

Press  Ctrl-End  to  save  this  information. 

[RECALL  command,  Language  Reference] 

Discard  marked  records 

This  action  discards  all  records  marked  for  deletion,  renumbers  the  records, 
and  reindexes  any  associated  indexes  that  are  open  at  the  time. 

After  choosing  this  action,  you’re  prompted  to  confirm  your  choice  by 
pressing  «-*. 

[PACK  command,  Language  Reference] 
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Generate  index 

This  action  generates  an  index. 

After  choosing  this  action,  enter  information  in  the  following  fields. 

In  the  Index  KEY  expression  field,  enter  the  key  expression.  The  key 
expression  can  be  any  number  of  fields  or  any  valid  dBASE  expression 
except  logical  expressions  and  memo  fields.  For  example,  you  could  enter 
Lastname  4-  Firstname.  An' entry  in  this  field  is  required.  [INDEX  command, 
key  expression,  Language  Reference ] 

In  the  Index  first  key  occurrence  only  (UNIQUE)  field,  choose  YES  to 
include  only  the  first  record  in  which  duplicate  values  occur,  and  NO  to 
index  all  records,  regardless  of  whether  the  database  file  includes  dupli¬ 
cates.  To  change  the  default  from  NO,  press  the  Spacebar.  [SET  UNIQUE 
or  INDEX  command,  Language  Reference ] 

In  the  Index  in  DESCENDING  order  field,  to  index  the  database  file  in 
descending  order,  press  the  Spacebar  so  that  YES  displays.  [INDEX  com¬ 
mand,  DESCENDING  option,  Language  Reference ] 

In  the  INDEX  file  field,  enter  the  index  file  you  wish  to  generate.  You  can 
enter  the  index  filename,  or  press  Shift-FI  Pick  to  choose  an  index  file  in 
the  current  catalog  or  directory.  You  can't  make  an  entry  in  this  field  if  you 
make  an  entry  in  the  TAG  and  MDX  fields.  However,  you  must  make  an 
entry  either  in  this  field  or  in  both  of  the  following  fields. 

In  the  TAG  field,  enter  the  index  tag  in  the  .mdx  file  specified  in  the  follow¬ 
ing  field.  You  can’t  make  an  entry  in  this  field  if  you’ve  made  an  entry  in 
the  INDEX  file  field  tbove.  [INDEX  command,  TAG  option,  Language 
Reference ] 

In  the  of  MDX  file  field,  enter  the  .mdx  file  for  the  tag  specified  in  the  TAG 
field.  Type  a  filename  or  press  Shift-FI  Pick  to  choose  a  name  from  the  cur¬ 
rent  catalog  or  directory.  You  can’t  make  an  entry  in  this  field  if  you’ve  made 
an  entry  in  the  INDEX  file  field  above.  [INDEX  command,  OF  option, 
Language  Reference] 

Press  Ctri-End  to  save  this  information. 

[INDEX  command,  Language  Reference] 

Reindex  database 

This  action  reindexes  a  database  file  after  the  file  length  has  been  changed  or 
the  key  field  changed  while  the  index  is  closed.  Press  «-*  to  rebuild  the  index 
and  return  to  Item.  [REINDEX  command,  Language  Reference] 

Physically  sort  database 

This  action  sorts  a  database  file.  A  SORT  reorganizes  records  and  writes 
them  to  a  new  database  file. 
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NOTE 

To  allow  users  to  SORT  a  database  file  of  their  own  choosing,  see 
"Giving  the  User  More  Control"  earlier  in  this  tab  section. 


After  choosing  this  action,  enter  information  in  the  following  fields. 

In  the  TO  file  field,  enter  the  name  of  the  file  in  which  the  sorted  records 
should  be  stored.  You  must  enter  a  name  in  this  field,  either  by  typing  it  or 
by  pressing  Shift-FI  Pick  to  choose  a  filename  from  the  current  catalog  or 
directory.  If  you  choose  a  filename  from  the  displayed  list,  the  sorted  records 
will  overwrite  the  data  in  the  existing  file. 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  that  are  to  be  sorted.  [SCOPE  clause, 
Language  Reference ] 

In  the  FOR  field,  enter  a  condition  that  must  be  met.  [FOR  clause,  Language 
Reference ] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  records  should  no 
longer  be  sorted  to  a  new  database  file.  [WHILE  clause,  Language  Reference] 

In  the  Sort  FIELDS  fields,  enter  the  sort  keys  (field  names)  in  their  order  of 
importance.  (For  example,  you  enter  the  primary  key  in  field  1,  the  second¬ 
ary  key  in  field  2,  and  so  forth.)  Type  in  the  field  names  or  press  Shift-FI  Pick 
to  choose  them  from  the  current  catalog  or  directory.  An  entry  in  the  first 
field  is  required. 

In  the  Sort  order  field,  which  is  not  labeled,  press  the  Spacebar  to  display 
ASCENDING  or  DESCENDING  order.  You  specify  whether  the  case  (capi¬ 
talization)  should  be  considered  in  the  sort  by  pressing  the  Spacebar  to  dis¬ 
play  IGNORE  CASE  or  USE  CASE. 

Press  Ctrl-End  to  save  this  information. 

[SORT  command,  Language  Reference] 


Import  foreign  file 

This  action  imports  a  non-dBASE  file  to  your  application.  It  allows  you 
to  import  from  PFS:FILE,  Framework  II™,  dBASE  II®,  RapidFile™,  and 
Lotus  1-2-3. 

After  choosing  this  action,  type  the  name  of  the  file  you  wish  to  import  in  the 
FROM  file  field  or  press  Shift-FI  Pick  to  choose  a  file  from  the  current  cata¬ 
log  or  directory.  An  entry  in  this  field  is  required. 


NOTE 

To  allow  users  to  import  database  files  of  their  choosing,  see  "Giving 
the  User  More  Control"  earlier  in  this  tab  section. 


In  the  of  type  field,  the  default  file  type  is  PFS.  To  change  it  to  dBASE  II, 
FW2  (Framework  II),  RPD  (RapidFile),  or  WK1  (Lotus  1-2-3),  press  the 
Spacebar  until  the  file  type  you  want  displays.  Press  Ctrl-End  to  save  this 
information. 
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NOTE 

You  can  use  dBASE  III  and  dBASE  III  PLUS  files  without  importing 
them. 


[IMPORT  command,  Language  Reference] 

Export  foreign  file 

This  action  exports  a  dBASE  IV  database  file  to  another  product.  It  allows 
you  to  export  a  dBASE  IV  database  file  to  PFS:FILE,  Framework  II, 
RapidFile,  and  dBASE  II. 

After  choosing  this  action,  enter  information  in  the  following  fields. 

In  the  TO  file  field,  enter  the  name  of  the  file  to  which  you  wish  to  export. 
Type  a  filename  in  this  field  or  press  Shift-FI  Pick  to  choose  a  file  from  the 
current  catalog  or  directory.  An  entry  in  this  field  is  required. 


In  the  of  type  field,  choose  the  file  type  for  the  exported  file.  The  default 
file  type  is  PFS.  To  change  it  to  dBASE  II,  FW2  (Framework  II),  or  RPD 
(RapidFile),  press  the  Spacebar  until  the  file  type  you  want  displays. 

In  the  FIELDS  field,  enter  the  database  fields  you  want  exported  to  the  file. 
You  can  type  them  in,  separating  each  field  with  a  comma,  or  you  can  use 
Shift-FI  Pick  to  choose  them  from  a  displayed  list.  If  you  don’t  enter  the  field 
names,  all  fields  in  the  assigned  database  file  or  view  will  be  exported  to  the 
new  file. 

The  list  that  displays  when  you  use  press  Shift-FI  Pick  contains  ail  the  fields 
in  the  assigned  database  file.  To  add  a  field,  select  it  and  press  «-*.  To  change 
your  mind  about  including  a  field,  select  it  and  press  «->  again.  To  find  a  field 
in  a  very  long  list,  type  the  first  letter  or  few  letters  of  the  field  name  if  you 
know  it.  The  first  field  that  matches  these  letters  will  be  highlighted. 

In  the  SCOPE  field,  enter  a  qualifier  (for  example,  ALL)  that  specifies  the 
extent  or  number  of  records  in  a  file  that  should  be  considered  for  export. 
[SCOPE  clause,  Language  Reference ] 

In  the  FOR  field,  enter  a  condition  that  must  be  met.  [FOR  clause,  Language 
Reference] 

In  the  WHILE  field,  enter  a  condition  that  specifies  when  records  should 
cease  being  exported.  [WHILE  clause,  Language  Reference] 

Press  Ctfi-End  to  save  this  information. 

[EXPORT  command,  Language  Reference] 


NOTE 

To  allow  users  the  option  to  export  database  files  of  their  choosing,  see 
“Giving  the  User  More  Control’’  earlier  in  this  tab  section. 
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Run  program 

This  action  runs  programs,  including  dBASE  or  DOS  programs,  batch  pro¬ 
cesses,  binary  files,  and  Control  Center  macros.  After  choosing  this  action, 
you  see  a  submenu  from  which  to  select  the  type  of  program  you  want  to 
run.  These  types  are  described  in  the  following  sections. 

Do  dBASE  program 

This  action  runs  a  dBASE  III  PLUS  or  dBASE  IV  program. 

In  the  Program  field,  enter  a  valid  dBASE  program  name  (a  .dbo,  .prg,  or 
.prs  file),  or  press  Shift-FI  Pick  to  select  a  .prg  file  from  the  displayed  list. 
Choosing  <  create  >  takes  you  to  the  program  editor,  where  you  can  enter 
the  lines  of  dBASE  code.  An  entry  in  this  field  is  required. 


NOTE 

To  give  your  users  the  opportunity  to  specify  a  program,  see 
“Giving  the  User  More  Control ”  earlier  in  this  tab  section. 


In  the  Parameters  field,  enter  the  parameters  for  the  program  specified  in 
the  Program  field,  according  to  the  parameter  statement  for  the  program  to 
be  run.  [DO  command,  Language  Reference ] 

Press  Ctri-End  to  save  your  choice. 

Execute  BATCH  process 

This  action  executes  a  batch  process  that  you  created  in  the  Applications 
Generator.  After  choosing  this  action,  you  can  either  type  the  batch  process 
name,  or  select  a  batch  process  from  the  list  that  displays  when  you  press 
Shift-FI  Pick.  An  entry  in  this  field  is  required. 


NOTE 

To  allow  your  users  to  specify  a  batch  process  to  run,  see  “Giving  the 
User  More  Control"  earlier  in  this  tab  section. 


Press  Ctri-End  to  save  your  choice. 

Insert  dBASE  code 

This  action  allows  you  to  specify  dBASE  code  that  you  want  to  run  when  a 
user  selects  a  list  or  an  item  from  a  menu.  For  example,  you  could  enter  set 
alternate  on. 
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NOTE 

For  further  information  on  dBASE  commands  and  basic  information 
you'll  need  to  write  dBASE  code,  see  Language  Reference.  If  you’ve 
purchased  dBASE  IV,  also  see  Introduction  to  the  Dot  Prompt  and 
Advanced  Topics.  If  you've  purchased  the  dBASE  IV  Developer's  Edi¬ 
tion,  also  see  Programming  with  dBASE  IV. 


After  you  choose  this  action,  a  full-screen  editing  frame  appears  on  the 
Applications  Generator  desktop  in  which  you  can  enter  up  to  19  lines  of 
dBASE  code.  When  you’re -through  entering  the  code,  press  Ctrl-Errd  to  save 
it. 

You  can  also  embed  code,  including  a  .prg  file,  that  runs  before  or  after  (or 
before  and  after)  an  object  is  displayed  to  the  user.  For  more  information, 
refer  to  “Object  Menus”  earlier  in  this  tab  section. 

Run  DOS  program 

This  action  runs  a  DOS  program.  After  choosing  this  action,  you  are  promp¬ 
ted  to  enter  the  program  name  and  the  parameters  for  the  program  to  be 
run. 


NOTE 

To  run  a  DOS  program,  you  need  memory  besides  that  required  to 
run  dBASE  IV.  For  more  information,  refer  to  the  RUN  command  in 
Language  Reference. 


In  the  Program  field,  type  a  valid  DOS  program  name  or  press  Shift-FI  Pick 
to  select  a  program  name  from  the  current  directory.  An  entry  in  this  field  is 
required. 

In  the  Parameters  field,  enter  the  parameters  for  the  program  specified  in 
the  Program  field,  according  to  the  syntax  for  the  program  to  be  run.  For 
example,  when  executing  the  CHKDSK  program,  the  fix  parameter  can  be 
passed  to  the  program  by  entering  /f  in  this  field.  This  field  does  not  relate 
to  the  dBASE  PARAMETERS  command. 

Load/call  binary  file 

This  action  loads  and/or  calls  a  binary  file.  This  type  of  file  is  written  in 
assembly  language.  The  filename  extension  is  .bin.  After  choosing  this  action, 
enter  the  filename  and  the  parameters  for  the  program  to  be  run. 

In  the  Program  field,  enter  the  name  of  the  .bin  program  to  load  and  call 
by  typing  the  filename  and  extension.  When  your  users  select  the  associated 
menu  item  for  the  first  time,  the  program  will  be  called  and  loaded.  An  entry 
in  this  field  is  required. 

In  the  Parameters  field,  enter  the  parameters  for  the  program  entered  in 
the  Program  field  according  to  the  syntax  for  the  program  to  be  called.  For 
example,  to  pass  an  integer  value  of  10  to  a  binary  program,  you  could  enter 
chr(IO)  in  this  field.  This  field  does  not  relate  to  the  dBASE  PARAMETERS 
command. 
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Play  Dack  macro 

This  action  calls  a  macro  created  through  the  Control  Center.  After  choos¬ 
ing  this  action,  you’re  asked  to  enter  the  macro  name.  Either  type  the  macro 
name,  or  press  Shift-FI  Pick  to  select  a  name  from  the  current  catalog  or 
directory.  An  entry  in  this  field  is  required. 


NOTE 

For  information  about  macros,  see  Chapter  14  of  Using  the  Menu  Sys¬ 
tem,  and  the  full-screen  SET  command  in  Language  Reference. 


Quit 


This  action  allows  users  to  quit  your  application  and  return  to  the  operating 
system  or  the  calling  program.  After  choosing  this  action,  select  Return  to 
calling  program  or  Quit  to  DOS  and  press  «-J.  Confirm  your  choice  by 
pressing  at  the  OK  prompt. 


Override  assigned  database  or  view 

This  option  specifies  the  database  file  or  view  that  you  want  the  current 
item  to  use  if  it's  different  from  the  one  you  specified  for  the  object  or  the 
application. 

After  choosing  this  option,  you  see  the  database  and  index  files  currently 
assigned  to  this  item.  Change  the  assignments  by  entering  information  in 
the  following  fields. 


For  this  item  you  may  use  values 

Make  a  choice  from  this  field  by  pressing  the  Spacebar.  If  you  choose  IN 
EFFECT  AT  RUN  TIME  or  ABOVE,  you  will  not  be  able  to  enter  values 
in  the  fields  that  follow. 

IN  EFFECT  AT  RUN  TIME  allows  you  to  specify  the  database  file  or  view 
that  was  in  use  just  prior  to  the  item  being  selected.  For  example,  if  the  first 
item  on  a  menu  opens  a  Files  list  containing  the  names  of  database  files,  and 
the  following  items  on  the  menu  are  to  use  the  database  file  chosen  by  the 
user,  these  items  should  be  assigned  IN  EFFECT  AT  RUN  TIME. 

You  may  enter  values  in  the  following  fields  if  you’ve  chosen  ENTERED 
BELOW. 


Database/view 

Enter  the  database  file  or  view  that  you  want  this  item  to  use.  Type  in  the 
name,  or  press  Shift-FI  Pick  to  see  the  database  files  and  views  in  the  current 
catalog  or  directory.  Choosing  the  <  create  >  marker  takes  you  to  the 
design  screen  where  you  can  specify  a  database  file.  If  this  item  uses  the 
same  database  file  or  view  as  used  by  the  current  object,  you  don’t  need  to 
enter  the  filename  here. 
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Set  INDEX  to 

Enter  the  index  files  to  be  used  with  the  database  file  or  view  for  the  selected 
item.  Either  enter  the  name  of  the  index  file  or  files,  separated  by  a  comma, 
or  use  Shift-FI  Pick  to  select  the  files.  If  this  item  uses  the  same  index  files  as 
the  current  object,  you  don’t  need  to  enter  an  index  file  here. 


NOTE 

You  can  choose  multiple  index  files  by  selecting  a  filename  and  press¬ 
ing  «-*,  selecting  another  filename  and  pressing  «-*,  and  so  forth,  until 
you’ve  selected  all  the  index  filenames  you  want.  Then,  press  Ctrl-End 
to  save  the  choices  and  exit  the  list. 


ORDER 

Enter  the  index  order  number  or  the  name  of  a  new  controlling  j  .dex,  if 
any.  If  this  item  uses  the  same  order  as  used  by  the  current  object,  you  don’t 
need  to  enter  the  order  here. 


Embed  code 

Use  this  option  to  add  dBASE  code  that  will  execute  either  before  or  after 
(or  before  and  after)  an  item  action  is  performed  at  run  time.  For  example, 
you  could  embed  dBASE  SET  commands  not  included  in  the  default  settings 
for  the  application  or  object. 

When  you  select  either  Before  or  After,  you  see  a  full-screen  editing  frame. 
Enter  up  to  19  lines  of  dBASE  code  inside  the  frame.  The  Applications  Gen¬ 
erator  doesn’t  check  code  syntax,  so  enter  or  modify  the  code  carefully.  (Use 
the  keys  described  in  Table  2-2  of  “The  Basics”  tab  section  to  modify  the 
code.)  Press  Ctrl-End  to  save  the  code  and  return  to  Item.  To  simplify 
this  process,  put  the  code  into  a  .prg  file,  and  embed  the  command  DO 
<  program  name  >  .prg. 


information  you’ll  need  to  write  programs  and  a  description  of  each 
command.  If  you've  purchased  dBASE  TV,  also  see  Introduction 
to  the  Dot  Prompt  and  Advanced  Topics.  If  you’ve  purchased  the 
dBASE  TV  Developer's  Edition,  also  see  Programming  with  dBASE  IV. 


NOTE 

This  option  is  for  application  developers  who  know  how  to  program 
in  dBASE.  If  you’re  new  to  dBASE,  see  Language  Reference  for  basic 


Bypass  item  on  condition 

Use  this  option  to  specify  a  condition  on  which  the  current  item  should  be 
skipped  at  run  time.  Complete  the  field  in  this  dialog  box  only  if  you’re 
defining  a  pop-up  menu. 
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Skip  this  item  if 

This  field  allows  you  to  create  a  condition  on  which  to  skip  the  current  item 
at  run  time.  Use  this  condition  only  for  actions  other  than  Text  (no  action). 
For  example,  to  specify  that  an  item  be  unavailable  to  your  users  if  its  asso¬ 
ciated  database  file  or  view  is  missing  from  the  directory,  enter  .NOT. 

<  filename  >  . 

Press  Ctrl-End  to  save  this  information. 

[DEFINE  BAR  command,  SKIP  FOR  clause,  Language  Reference ] 


Position  record  pointer 

This  option  sets  the  record  position  before  the  action  begins.  It  allows  you 
to  specify  the  record  you  want  to  use  first  in  this  action.  After  choosing  this 
option,  you  see  the  dialog  box  shown  in  Figure  4-11. 


Figure  4-1 1  Set  position  in  file 
Descriptions  of  the  fields  follow. 

Display  POSITIONING  MENU  at  RUN  TIME? 

This  field  allows  you  to  present  a  record  positioning  menu  to  your  users. 
This  menu  is  illustrated  in  Figure  4-12.  (The  Applications  Generator  auto¬ 
matically  creates  this  menu.) 

The  action  will  not  begin  until  the  user  enters  a  positioning  choice.  The 
default  for  this  field,  NO.  tells  the  Applications  Generator  not  to  include 
the  positioning  menu  here.  If  you  want  to  control  where  the  action  starts, 
accept  the  default  and  make  an  entry  in  one  of  the  other  fields. 

If  you  want  to  give  users  a  choice  of  record  position,  simply  press  the 
Spacebar  to  display  YES.  You  can’t  change  the  default  from  NO  if  you've 
entered  values  in  any  other  field  in  this  dialog  box. 
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Figure  4-12  Record  positioning  menu 


SEEK  first  occurrence  of  key 

Specify  a  valid  dBASE  expression  that  has  the  same  data  type  as  the  index 
key  expression.  This  expression  should  indicate  the  particular  record  where 
the  action  should  start.  Every  record  of  an  indexed  file  is  searched  until  a 
match  is  found.  For  example,  entering  "Santa  Fe"  would  cause  your  applica¬ 
tion  to  go  to  the  first  record  in  which  the  string  "Santa  Fe"  is  found  in  the 
key  field.  If  you’ve  made  an  entry  in  another  field,  you  can’t  make  an  entry 


here. 


NOTE 


a  The  file  must  be  indexed  to  use  this  command,  and  the  index  file  must 
be  the  controlling  index.  So,  specify  an  index  in  the  Override  assigned 
database  or  view  option  on  the  Item  menu  if  you  haven’t  yet  specified 
one  for  this  item,  object,  or  application. 

[SEEK  command,  Language  Reference ] 


GOTO 


Specify  an  exact  location  where  a  particular  action  starts  in  a  file.  This 
field  and  your  entry  are  based  on  the  syntax  required  by  the  dBASE  GOTO 
command. 

The  basis  for  the  search  is  the  physical  order  of  the  record  in  an  index  file 
or  an  unindexed  database  file.  For  example,  entering  TOP  indicates  that  the 
action  should  start  at  the  beginning  of  the  file,  at  the  first  record.  You  can 
also  enter  BOTTOM  or  a  particular  record  number,  including  a  numeric 
expression  such  as  RECNO(),  RECNO()  +  1,  and  so  forth.  You  can't  make  an 
entry  in  this  field  if  you’ve  made  an  entry  in  another  field  in  this  dialog  box. 

[GOTO  command,  Language  Reference ] 


LOCATE 


In  the  following  fields,  specify  a  particular  record  where  you  want  an  action 
to  start.  This  command  works  with  any  file,  indexed  or  not;  however,  it's 
slower  than  SEEK.  [LOCATE  command,  Language  Reference ] 
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SCOPE,  FOR,  WHILE 

In  the  SCOPE  field,  enter  a  condition  that  specifies  the  extent  or  number  of 
records  to  be  searched.  [SCOPE  clause,  Language  Reference] 

In  the  FOR  field,  enter  a  search  condition  for  the  LOCATE  command  just 
explained.  It’s  different  from  the  SCOPE  condition  because  it  requires  that 
a  specific  condition  be  met.  You  can’t  make  an  entry  in  this  field  if  you’ve 
made  an  entry  in  any  of  the  top  three  fields.  [FOR  clause,  Language 
Reference ] 

In  the  WHILE  field,  enter  a  search  condition  for  the  LOCATE  command  just 
explained.  You  can’t  make  an  entry  in  this  field  if  you’ve  made  an  entry  in 
any  of  the  top  three  fields.  [WHILE  clause,  Language  Reference] 

Press  Ctri-End  to  save  this  information. 


Reassign  index  order 

Use  this  option  to  specify  the  index  or  tag  for  the  action  being  defined.  When 
you  choose  this  option,  you  see  the  Set  ORDER  to  field.  You  enter  a  sort 
order  number  (0  to  7),  an  .ndx  filename,  or  .mdx  tag.  You  can  also  specify 
an  .mdx  filename  using  the  OF  clause.  An  entry  in  this  field  is  required. 

Press  Ctrl-End  to  save  this  information. 

[SET  ORDER  TO  command,  Language  Reference] 


Define  logical  window 

Use  this  option  to  define  a  window  that  will  display  when  an  action  takes 
place.  For  example,  you  could  define  a  window  in  which  the  user  browses 
a  database  file.  When  you  choose  this  option,  you  see  the  dialog  box  shown 
in  Figure  4-13. 
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Figure  4-13  Define  logical  window 


Descriptions  of  the  fields  follow. 


NOTE 

Specifying  a  logical  window  for  certain  actions  doesn't  make  sense. 
These  include  Open  a  menu,  Return  to  calling  program,  and  the 
Quit  to  DOS  actions  under  Quit. 


Window  NAME 

Enter  the  name  of  the  window  for  the  action  you’re  defining.  An  entry  in 
this  field  is  required,  and  it  must  be  a  legal  dBASE  window  name.  [DEFINE 
WINDOW  command,  Language  Reference ] 


Display  border  as 

Specify  the  type  of  border  for  the  action  window.  The  default  is  SINGLE, 
meaning  that  the  border  will  consist  of  a  single  line.  To  change  it  to 

DOUBLE,  PANEL,  CUSTOM,  or  NONE,  press  the  Spacebar. 

Choosing  DOUBLE  creates  a  double-line  border.  Choosing  PANEL  creates 
a  single-line  border  that  displays  in  inverse  video  on  monochrome  monitors. 
Choosing  CUSTOM  creates  a  border  with  the  features  you  specify  in  the  next 
field.  Choosing  NONE  creates  a  window  with  no  border.  [SET  BORDER 
command,  Language  Reference ] 


Border  characters  (for  CUSTOM  borders) 

Enter  the  characters  or  numbers  for  the  border  of  this  window.  To  enter 
characters  directly,  you  must  enclose  them  within  a  delimiter  other  than 
double  quotation  marks.  You  can  use  single  quotation  marks  or  left  and  right 
brackets  [].  For  example,  to  create  a  border  of  asterisks,  you'd  enter 
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You  can  also  enter  ASCII  codes,  separated  by  commas,  to  represent  other 
characters.  These  numbers  need  not  appear  between  delimiters.  For  exam¬ 
ple,  setting  the  previous  field  to  DOUBLE  and  entering  ,,  179,  179,  213,  184, 
212,  190  would  create  a  border  in  which  the  top  and  bottom  have  double 
lines,  and  the  sides  have  single  lines.  See  Language  Reference  for  more  infor¬ 
mation  about  ASCII  character  equivalents. 

An  entry  in  this  field  is  required  if  you  specified  CUSTOM  in  the  previous 
field. 

[SET  BORDER  command,  Border  definition  string  option,  Language 
Reference ] 


Colors 


Specify  the  standard,  enhanced,  border,  and  background  colors  for  this  win¬ 
dow.  For  example,  entering  GR  +  /R.W/R.GR  +  would  set  standard  video 
with  yellow  letters  on  a  red  background,  enhanced  (highlighted)  video  with 
white  letters  on  a  red  background,  and  the  border  to  yellow.  [SET  COLOR 
command,  Language  Reference ] 

UPPER  LEFT  comer  at  row  and  column 

Enter  the  screen  coordinates  for  the  upper  left  comer  of  the  window  in 
these  fields.  The  default  for  row  is  2,  and  the  default  for  column  is  0.  Entries 
in  these  fields  are  required.  [DEFINE  WINDOW  command,  FROM  clause, 
Language  Reference ] 


LOWER  RIGHT  comer  at  row  and  column 

Enter  the  screen  coordinates  for  the  lower  right  comer  of  the  window  in 
these  fields.  The  default  for  row  is  20,  and  the  default  for  column  is  79. 
Entries  in  these  fields  are  required.  [DEFINE  WINDOW  command,  TO 
clause,  Language  Reference] 

Press  Ctri-End  to  save  this  information. 


Write  help  text 

Use  this  option  to  write  the  help  text  for  the  item  you’re  defining.  This  help 
text  will  appear  at  run  time  if  this  item  is  chosen  and  the  user  presses 
FI  Help.  If  you  don’t  write  help  text  for  this  item,  the  user  will  see  the  help 
text  written  for  the  menu  or  list.  If  you  didn’t  write  help  text  for  the  menu 
or  list,  the  user  will  see  the  message  No  help  defined. 

After  choosing  this  option,  a  full-screen  editing  frame  appears  on  the  work 
surface  in  which  you  can  enter  up  to  19  lines  of  text.  Use  this  window  to 
enter  or  modify  the  help  text.  When  you  finish,  press  Ctrl-End  to  save  the 
text  and  return  to  Item. 
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Assign  message  line  prompt 

Use  this  option  to  specify  a  prompt  for  the  item  being  defined.  At  run  time, 
the  prompt  will  appear  in  the  message  line  when  the  item  is  highlighted.  If 
you  don’t  enter  a  prompt  for  the  item,  any  prompt  you  specified  for  the 
menu  or  list  will  display. 


After  choosing  this  option,  you  see  the  prompt,  if  any,  assigned  to  the  menu 
or  list,  and  the  type  of  object.  To  change  the  prompt  from  the  one  you  speci¬ 
fied  for  the  menu  or  list,  enter  up  to  76  characters  in  the  field  indicated  by 
the  cursor.  Double  quotation  marks  are  not  permitted. 


Generate 


Use  the  options  on  the  Generate 
menu  to  produce  the  code  and 
the  documentation  for  your  appli¬ 
cation.  The  code  comprises  the 
dBASE  programs  that  will  run  your 
application,  and  the  documentation 
is  a  record  of  the  objects  you  cre¬ 
ated  in  the  Applications  Generator. 


The  Applications  Generator  generates  the  code  or  documentation  by  taking 
the  information  added  as  you  built  objects  and  merging  it  with  a  template. 
The  templates  contain  instructions  to  dBASE  for  generating  code  or 
documentation. 

In  the  process  of  generating  code,  the  Applications  Generator  creates  two 
program  files,  <  appr  ame  >  .prg  and  <  mainmenu  >  .prg.  You'll  need  these 
files  in  the  same  directory  to  run  your  application  later.  For  documentation, 
the  Applications  Generator  creates  a  file  with  the  name  you  assigned  to  the 
application  object,  plus  the  .doc  extension. 


NOTE 


You  can  learn  more  about  these  template  files  in  Template  Language, 
IfcJi  which  is  included  in  the  dBASE  IV  Developer's  Edition.  If  you  don’t 
have  this  product,  you  can  order  it  with  the  card  enclosed  in  the 
dBASE  IV  package. 

The  Applications  Generator  creates  the  documentation  and  code  quickly; 
however,  the  actual  generation  time  depends  on  both  your  equipment  and 
the  size  of  your  application.  You  must  wait  for  the  Applications  Generator 
to  finish  before  trying  to  exit  and  run  your  application. 

Before  running  the  application,  you  may  wish  to  print  the  documentation 
and  code.  As  you  test  your  application,  you  can  note  design  changes  on  the 
documentation,  and  note  any  syntax  changes  on  the  code. 
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NOTE 

If  you  change  one  object,  you  must  regenerate  the  entire  application. 
Otherwise,  the  change  will  not  appear  in  the  application  when  you 
run  it. 


The  first  option  on  the  Generate  menu  is  Begin  generating.  It  appears  first 
on  the  menu  because  it'sjused  most  often.  Before  using  it,  however,  be  sure 
that  the  other  two  menu  options  are  set  to  your  preferences,  as  explained  in 
the  following  sections. 


Begin  generating 

Choosing  this  option  causes  the  Applications  Generator  to  generate  object 
documentation  or  dBASE  code,  depending  on  the  choice  you  made  in  the 
Select  template  option.  You  can  request  that  the  documentation  or  the  code 
appear  on  the  screen  as  it’s  generated  with  the  Display  during  generation 
option. 

If  you  didn't  specify  a  main  menu  for  this  application  when  you  entered  the 
Applications  Generator,  you  must  do  so  now.  Press  the  Spacebar  to  choose  a 
main  menu  type,  either  BAR,  POP-UP,  or  BATCH.  Then  type  the  menu 
name  or  press  Shift-FI  Pick  to  choose  one  from  the  current  directory. 

Once  the  documentation  or  code  is  generated,  you  may  wish  to  print  the 
documentation  and  code,  and  test  the  application.  For  information  on  these 
tasks,  refer  to  Chapter  3,  "A  Sample  Application.” 


Select  template 

This  option  allows  you  to  specify  the  template  used  by  the  Applications  Gen¬ 
erator  to  create  code  or  documentation,  after  you’ve  made  the  application 
object  current.  When  you  choose  this  option,  you  can  accept  the  default  tem¬ 
plate,  MENU.GEN,  or  type  in  another  template  name.  You  save  your  entry 
by  pressing  «-J  or  Ctri-End.  A  description  of  the  templates  follows: 

The  Document.gen  template  is  merged  with  the  information  you  entered  as 
you  created  your  application  to  produce  an  <  appname  >  .doc  file.  This  file 
contains  the  descriptions,  or  documentation,  of  the  objects  in  your  applica¬ 
tion.  A  printed  version  of  the  documentation  is  useful  to  have  as  you’re  test¬ 
ing  the  application.  As  you  test,  you  can  note  changes  you  want  to  make  on 
the  hard  copy. 

The  Menu.gen  template  is  merged  with  the  information  you  entered  as  you 
created  your  application  to  produce  two  program  (.prg)  files  —  one  for  the 
application  and  one  for  the  objects  used  in  the  application.  The  names  of 
these  files  are  <  appname  >  .prg  and  <  mainmenu  >  .prg,  and  they  contain 
the  dBASE  code  needed  to  run  your  application. 
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The  Quickapp.gen  template  is  merged  with  the  information  you  entered  after 
choosing  the  Generate  quick  application  option  from  the  Application 
menu  to  produce  an  <  appname  >  .prg  file.  This  file  contains  the  code 
needed  to  run  a  simple,  one-menu  application.  (If  you  did  not  specify  a 
quick  application,  entering  this  template  name  and  choosing  Begin  gen¬ 
erating  will  produce  code  for  a  simple,  one-menu  application  that  uses  the 
default  screen  format  file  and  the  database  file  assigned  to  the  application 
object.) 


NOTE 

These  three  templates  come  with  the  Applications  Generator.- To  learn 
about  modifying  them  or  creating  other  templates,  see  Template  Lan¬ 
guage,  which  comes  with  the  dBASE  IV  Developer's  Edition.  (If  you 
don't  own  this  product,  you  can  use  the  enclosed  order  card  to  pur¬ 
chase  it.) 


Display  during  generation 

After  choosing  this  option,  you're  asked  whether  you  want  to  see  the  code  or 
documentation  displayed  as  it’s  generated.  Accept  the  default,  Yes,  or  choose 
No  by  pressing  the  Spacebar.  (Choosing  No  causes  the  generation  to  occur 
at  a  slightly  faster  speed  than  if  the  code  is  displayed  on  the  screen.)  Then, 
press  «->.  When  you  choose  Begin  generating,  you’ll  see  a  line  count  in  the 
status  bar  at  the  bottom  of  the  screen. 


Preset 

The  Preset  menu  options  allow  you 
to  specify  information  that  remains 
constant  for  each  application  you 
design,  unless  you  change  it  for  a 
specific  application.  For  example, 
you  can  specify  that  your  name, 
copyright  notice,  and  the  dBASE 
version  you’re  using  appear  in  each 
application  sign-on  banner. 


NOTE 

You  can  change  information  that  is  specific  to  an  application  by 
choosing  options  in  the  Application  menu.  That  menu  is  described 
earlier  in  this  tab  section. 


Sign-on  defaults 

When  you  design  an  application,  you  might  want  the  first  screen  that  appears 
to  be  a  sign-on  banner.  The  sign-on  banner  usually  specifies  who  wrote  the 
application,  gives  the  copyright  notice,  and  specifies  the  versions  of  dBASE 
that  can  be  used  to  run  the  application. 
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When  you  choose  this  option,  you  see  three  fields:  Author,  Copyright 
notice,  and  dBASE  version.  Enter  the  appropriate  information  into  each 
field,  using  «-<  to  move  among  the  fields.  If  you  make  a  mistake  when  add¬ 
ing  information,  just  backspace  to  make  corrections.  Press  Ctrt-End  to  save 
the  changes. 

You  can  enter  any  type  of  information  in  these  fields.  For  example,  you  can 
type  a  standard  greeting  to  your  users  in  these  fields,  rather  than  your  name, 
copyright  notice,  or  dBASE  version.  If  you  still  want  your  name,  copyright 
notice,  or  dBASE  versio‘n.to  appear  in  the  object  documentation  or  code,  use 

the  Edit  program  header  comments  option  in  the  Application  menu. 

The  next  time  you  create  an  application  object,  this  information  will  auto¬ 
matically  display  in  the  object  itself.  (The  current  application  object  will  not 
reflect  these  changes.)  You  can  then  size  the  object  and  add  other  informa¬ 
tion.  You  can  also  move  the  information  within  the  application  object  using 
the  navigation  keys  explained  in  the  first  tab  section,  "The  Basics.”  To  use  an 
application  object  as  a  sign-on  banner,  choose  the  Display  slgn-on  banner 
option  in  the  Application  menu. 


Display  options 

This  option  is  the  same  as  the  Modify  display  options,  which  is  described 
earlier  in  this  chapter. 


Environment  settings 

This  option  sets  the  default  environment  for  all  your  applications.  It  allows 
you  to  turn  environmental  settings  on  or  off.  For  example,  with  Set  BELL, 
you  can  cause  a  warning  signal  to  sound  when  users  have  entered  invalid 
data  or  have  reached  the  end  of  an  input  area  on  a  form. 

In  the  to  field  on  the  Set  BELL  line,  enter  the  frequency  and  duration  of  the 
signal,  separated  by  a  comma  if  you  want  these  settings  to  differ  from  the 
defaults  of  550,2.  Both  or  neither  numbers  must  be  specified. 

In  the  to  field  on  the  Set  DELIMITERS  line,  enter  the  delimiters  if  Set 

DELIMITERS  is  ON. 

Press  to  move  among  the  settings,  and  the  Spacebar  to  change  a  setting. 
When  you're  satisfied  with  the  settings,  press  Ctrl-End.  You  can  change  these 
settings  for  a  specific  application  or  object  by  choosing  Modify  application 
environment  from  the  Application  menu,  or  Modify  display  options  from 
the  Menu  or  List  menus. 

[SET  commands,  Language  Reference ] 


Application  drive/path 

Use  this  option  to  enter  the  default  drive  and  search  path  for  all  applications 
created  with  the  Applications  Generator.  You  can  change  the  drive  and  path 
for  an  individual  application  by  choosing  the  Modify  application  environ¬ 
ment  option  in  the  Application  menu. 
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In  the  drive  field,  enter  the  name  of  the  drive  on  which  all  operations 
should  take  place  and  where  all  non-Applications  Generator  objects  can  be 
found  at  run  time.  Pressing  Shift-FI  Pick  displays  a  list  from  which  you  can 
choose  the  drive  name.  [SET  DEFAULT  command,  Language  Reference ] 

In  the  search  path  field,  enter  the  directory  path  your  application  will 
search  to  find  objects,  such  as  reports. 

[SET  PATH  command,  Language  Reference ] 


Exit 

You  use  options  on  the  Exit  menu 
to  save  or  abandon  changes  and 
exit  the  Applications  Generator  to 
the  Control  Center  or  dot  prompt. 
If  you  choose  the  second  option 
from  Exit  and  change  your  mind 
about  leaving  the  Applications  Gen¬ 
erator,  you  can  always  press  Esc  to 
exit  the  dialog  box. 

Save  all  changes  and  exit 

Choosing  this  option  saves  all  objects  on  the  work  surface  and  ends  the  ses¬ 
sion  in  the  Applications  Generator.  If  you’ve  made  changes  to  objects  but 
haven’t  previously  saved  them  with  Save  current  <  object  >  in  the  object 
menus,  the  changes  will  be  saved  with  this  option. 

The  modified  object  replaces  the  previous  version  of  the  object  when  you 
save  and  exit. 

As  mentioned  in  the  “Preset”  section,  modifying  an  application  object  and 
saving  it  under  a  new  name  allows  you  to  create  generic  applications  that 
you  can  easily  customize  for  specific  users. 


Abandon  all  changes  and  exit 

Choosing  this  option  discards  the  changes  made  to  all  objects  on  the  work 
surface  and  ends  the  session  in  the  Applications  Generator.  When  you  aban¬ 
don  changes,  the  objects  remain  as  they  were  last  saved. 

If  you  choose  Yes  from  the  confirmation  box  that  displays,  the  Applications 
Generator  abandons  the  changes,  clears  the  work  surface,  and  returns  to  the 
Control  Center  or  dot  prompt,  depending  on  the  component  from  which  you 
entered  the  Applications  Generator. 

If  you  choose  No,  you  return  to  the  Applications  Generator  menu  bar,  and 
the  modified  objects  remain  intact  on  the  work  surface. 
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Action 

Application 


Application  object 


Applications 

Generator 

Attributes 


Code 

Code  embeds 


dBASE  IV 

Applications 

Generator 

Debugging 
Dialog  box 


Glossary 


The  task  assigned  to  an  item  on  a  menu  or  batch  process,  or  to  a 
list. 

(1)  A  set  of  programs  that  allows  users  to  perform  a  number  of 
related  tasks  —  for  example,  an  accounting  application.  (2)  A  set 
of  objects  that  function  together  to  allow  users  to  perform  tasks. 

The  application  becomes  functional  once  code  is  generated  for 
these  objects.  See  also  application  object. 

The  unifying  object  of  an  application  created  with  the  Applications 
Generator.  All  other  objects  are  tied  to  the  application  object,  which 
always  appears  on  the  work  surface  of  the  Applications  Generator 
desktop  and  can  serve  as  a  sign-on  banner. 

See  dBASE  IV  Applications  Generator. 

Characteristics  assigned  to  objects  in  an  application  —  for  example, 
double-line  frames  or  a  specific  color.  Also,  characteristics  assigned 
to  items  in  an  object  —  for  example,  code  embeds  or  help  text. 

See  horizontal  bar  menu. 

An  object  that  performs  a  number  of  tasks  out  of  view  of  the  user 
(for  example,  copying  a  database  file  and  then  discarding  marked 
records). 

The  commands  that  tell  the  computer  what  to  do.  You  can  write 
dBASE  IV  code,  or  automatically  generate  it  using  the  Applications 
Generator. 

dBASE  IV  code  inserted  before  or  after  an  object  or  item  in  an 
application  created  with  the  Applications  Generator.  Code  embeds 
give  application  developers  the  ability  to  add  additional  functional¬ 
ity  to  their  applications.  A  code  embed  may  DO  a  .prg  (program) 
file. 

A  component  of  dBASE  IV  that  simplifies  the  process  of  building 
applications  by  providing  a  design  area  and  generating  the  code 
needed  to  run  them. 

See  testing. 

A  box  in  which  you  are  requested  to  provide  information  as  you 
build  an  application. 
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Files  list 

A  list  that  displays  files  of  a  specified  type  —  for  example,  a  list  of 
*.frm  (report)  files. 

Full-screen  editing 
frame 

Horizontal  bar 
menu 

A  box  in  which  to  enter  help  text  or  code  embeds. 

A  horizontal  display  of  menu  items,  usually  at  the  top  of  the  screen. 
Pull-down  menus  are  often  attached  to  the  menu  items  on  a  hori¬ 
zontal  bar  menu." 

Inheritance 

The  process  by  which  objects  or  items  automatically  obtain  the 
attributes  assigned  to  another  object  or  the  host  object,  respec¬ 
tively.  These  automatic  assignments  can  be  changed  later. 

Item 

A  choice  on  a  menu,  list,  or  batch  process  created  with  the  Applica¬ 
tions  Generator.  You  assign  actions  to  each  item  on  a  menu  or 
batch  process,  or  to  a  list,  using  the  Item  menu.  See  also  menu 
option. 

List 

An  object  that  displays  items  of  one  type.  The  same  action  is 
assigned  to  all  the  items  on  the  list. 

Menu 

An  object,  such  as  a  horizontal  bar,  pull-down,  or  stand-alone 
(pop-up)  menu,  that  presents  action  choices  to  the  user. 

Menu  option 

A  choice  displayed  in  the  dBASE  IV  Applications  Generator  menu 
system. 

Message  line 
prompt 

Object 

A  message  that  you  specify  to  appear  when  a  user  selects  a  menu, 
list,  or  application  object. 

A  database  or  query  file,  report,  form,  menu,  list,  or  batch  process 
used  in  an  application  created  with  the  Applications  Generator.  See 
also  application  object. 

Object 

documentation 

A  record  of  the  objects  you  create  with  the  Applications  Generator. 
At  your  request,  the  Applications  Generator  will  create  object  docu¬ 
mentation  for  you. 

Pop-up  menu 

A  menu  with  a  vertical  presentation  of  items.  It  may  stand  alone  or 
be  attached  to  a  horizontal  bar  menu  as  a  pull-down  menu. 

Program 

Lines  of  code  (computer  commands)  that  perform  some  function. 

A  program  often  serves  as  a  module,  or  part,  of  an  application. 

Pull-down  menu 

A  pop-up  menu  or  list  that  is  attached  to  a  menu  item  on  a  horizon¬ 
tal  bar  menu. 

Run  time 

The  time  when  an  application  is  run  from  the  dot  prompt,  Control 
Center,  or  from  the  operating  system. 

Sign-on  banner 

The  application  object  when  used  as  the  first  screen  seen  at  run 
time. 

Structure  list 

A  list  that  presents  the  field  names  of  a  database  file  or  view  to 
users. 

Testing 

Noting  and  fixing  design  problems  or  errors  in  the  code  of  an 
application. 
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User  interface 
Values  list 
Work  surface 


The  menus,  lists,  and  other  objects  that  display  to  the  user  at  run 
time. 

A  list  that  presents  the  values,  or  contents,  of  one  field  in  a  data¬ 
base  file  or  view  to  users. 

The  area  of  the  Applications  Generator  desktop  in  which  you  design 
and  lay  out  the  objects  of  your  applications. 
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Batch  Process  menu  bar 


Design  Batch  Item 


Generate  Preset 
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Design 


Menu  menu  bar.  page  B-2 

List  menu  bar.  page  B  3 

Batch  Process  menu  bar,  page  B-4 

l 


Design 
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Item 


Ob|ect  menu  bar,  Page  B  1 
Menu  menu  bar.  page  B  2 
List  menu  bar,  page  B  3 
Batch  Process  menu  bar.  page  B  4 


Object: _ 

Item: _ 

Current  database/view _ _  using  index 

This  item  will _ 


OK 


These  values  are  currently  assigned  to  the  object 
Database/ view:  Your  DBF 
Set  INDEX  to:  Your  MDX 
ORDER: 

For  this  item  you  may  use  values:  ABOVE 
Database/view: 

Set  INDEX  to: 

ORDER: 


1 

Item 
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Item/Change  action 


CD 


Page  B  6 

l 


Text  (no  action) 

Open  a  menu 

Browse  (add,  delete,  edit) 

Edit  form  (add.  delete,  edit) 

Display  or  print - 

Perform  tile  operation - 


Return  to  calling  program  RETURN 

Quit  to  DOS  QUIT 


- Page  B  9 

- ►  Page B 11 


This  action  will  return  control  to 
the  operating  system 

OK 


This  action  will  return  control  to  the  program 
(or  operating  system)  from  which  the  application 
was  invoked 


OK 


Append/Edit  via  Form  file 

FORMAT  file:  Mode  APPEND 

FIELDS. 

FILTER 

SCOPE: 

FOR 

WHILE: 

Allow  record  ADD? 

YES 

Allow  record  EDIT? 

YES 

Allow  record  DELETE? 

YES 

KEEP  image  on  exit? 

NO 

Display  Edit  MENU? 

YES 

Use  PREVIOUS  Browse  table? 

NO 

FOLLOW  record  after  update? 

YES 
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Item/Change  action/Display  or  print 
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i 


Report 

REPORT  FORM 

Labels 

LABEL  FORM 

Display/list 

DISPLAY/LIST 

Display/List  Database  tile  Records 

PAUSE  at  full  page/screen?  YES 

Send  output  to:  PRINTER 

Include  RECORD  NUMBERS?  YES 

FIELDS; _ 

FILTER; _ 

SCOPE _ 

FOR: _ 

WHILE; _ 


FORM  name: 

Print  Labels 

Send  output  to: 

PRINTER 

Print  SAMPLE? 

YES 

FILTER: 

SCOPE: 

FOR: 

WHILE: 

Form  name: 

Print  a  Report 

HEADING: 

Report  format: 
Heading  format: 
Before  printing: 
Send  output  to: 

FULL  DETAIL 

PLAIN 

SKIP  TO  NEW  PAGE 

PRINTER 

FILTER: 

SCOPE 

FOR: 

WHILE: 
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Item/Change  action/Perform  file  operation 


(TO  file  will  be  overwritten) 


COPY  fit 
TO  file:_ 


Add  records  FROM  file/array^. 
OF  TYPE:  DBF 


DELIMITER  (other  than ")  for  delimited  type:_ 
FOR  _ 


(TO  file  will  be  overwritten) 


Copy  records  TO  file/array  _ 
OF  TYPE  DBF 


DELIMITER  (other  than  ")  for  delimited  type:_ 


FIELDS: 

SCOPE 

FOR: 


Substitute  Field  Values 


SCOPE  _ 
FOR: _ 


REPLACE  the  contents  of:  ADDITIVE 

The  field  named  With  this  value:  option? 


File  copy 

Add  records  from  file 
Copy  records  to  file 
Substitute  field  values 
Mark  records  for  deletion 
Unmark  records 
Discard  marked  records 

Generate  index  - 

Reindex  database  - 

Physically  sort  database  - 

Import  foreign  file - 

Export  foreign  file - 


This  selection  will  cause  all 
records  marked  tor  deletion  to 
be  removed  from  the  c 


SCOPE 
FOR: _ 


W 

<o 
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Item/Change  action/Perform  file  operation,  continued 


From  page  B-9 


This  selection  will  cause  all  active  index 
files  for  the  currently  selected  database 
or  view  to  be  rebuilt 

OK 


Generate  Index 

Index  KEY  expression 

Index  first  occurrence  only  (UNIQUE)? 

NO 

Index  in  DESCENDING  order? 

NO 

Generate  index  to:  INDEX  tile _ 

OR  TAG: _ 

of  MDX  file: _ 

File  copy 

Add  records  from  tile 
Copy  records  to  file 
Substitute  field  values 
Mark  records  tor  deletion 
Unmark  records 
Discard  marked  records 
Generate  index 
Reindex  database 
Physically  sort  database 
Import  foreign  file 
Export  foreign  file 


COPY  FILE 
APPEND  FROM 
COPY  TO 
REPLACE 
DELETE 
RECALL 
PACK 
INDEX  ON 
REINDEX 
SORT  TO 
IMPORT 
EXPORT 


(TO  file  will  be  overwritten) 

TO  tile: _ of  type:  PFS 

FIELDS; _ 

SCOPE _ 

FOR _ 


Physically  Sod  a  Database 
(will  be  overwritten) 


TO  file: 
SCOPE: 
FOR: 
WHILE: 


Sod  FIELDS:  1 
2 

3 

4 

5 


ASCENDING 

ASCENDING 

ASCENDING 

ASCENDING 

ASCENDING 


IGNORE  CASE 
IGNORE  CASE 
IGNORE  CASE 
IGNORE  CASE 
IGNORE  CASE 
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Item/Change  action/Run  program 
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MENU  TREES 


Application 


Main  menu  type  BAR 


Display  frame  as  'sign-on  banner*  at  run  time? 
(Yes)  [No] 


Ob)ect  border  si 

Standard  All 
Normal  text 
Messages 
Titles 

Enhanced  All 
Highlight 
Boxes 
Information 
Fields 


Foreground 

Background 

>  Black 

>  Black 

Blue 

Blue 

Green 

Green 

Cyan 

Cyan 

Red 

Red 

Magenta 

Magenta 

Brown 

Brown 

White 

Grt* 

Lt  Blue 

Lt  Green 
LtCyan 

Lt  Red 

Lt  Magenta 
Yellow 

Bn  White 

White 

Display  options 
Environment  settings 
Search  path 

View/database  and  index 


Database/view 
Set  INDEX  to: 
ORDER 


Drive 
Search  p 


Set  BELL 
Set  CARRY 
Set  CENTURY 
Set  CONFIRM 
Set  ESCAPE  ON 
Set  SAFETY  ON 
Set  DELIMITERS  OFF  (to 


OFF 

OFF 

OFF 


(to 


Application  menu  bar,  Page  B  1 

1 


Application 


C 


Name  and  describe 
Assign  main  menu 
Display  sign -on  banner 
Edit  program  header  comments 
Modify  application  environment 
Generate  quick  application 


Save  current  application  definition 


Clear  work  surtace 


The  current  frame  has 
been  modified  Action? 
Save  changes 
Abandon  changes 


Database  file; _ Screen  format  (ile^_ 

Report  format  file _ Label  format  tile: _ 

Set  INDEX  toj _ 

ORDER: _ 

Application  author _ 

Application  menu  heading : _ 


Select  YES  to  generate  the  quick  application:  select  NO  to  cancel 
(Yes|  |No| 
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Introduction 


About  This  Book 

This  book  shows  you  how  to  use  the  SQL  (Structured  Query  Language)  com¬ 
mands  provided  by  dBASE  IV.  You’ll  learn  basic  database  concepts  used  by 
SQL  and  run  examples  that  demonstrate  SQL  commands. 

SQL  provides  a  compact  set  of  commands  you  can  use  to  define,  query,  and 
update  data  in  a  database.  You  can  execute  SQL  commands  interactively 
or  use  SQL  with  dBASE  commands  in  database  application  programs.  The 
SQL  commands  implemented  in  dBASE  IV  are  the  same  as  those  in  IBM’s 
DATABASE  2  (DB2)®  and  SQL/DS®  mainframe  computer  database  products. 


How  to  Use  This  Book 


How  you  use  this  book  will  depend  on  your  previous  experience  with  either 

dBASE  or  SQL.  The  description  of  each  chapter  given  below  should  help  you 

decide  where  to  begin  and  how  to  proceed. 

■  Chapter  1  —  Introduces  SQL  database  concepts  and  describes  how  you 
can  use  SQL  in  dBASE  IV. 

■  Chapter  2  —  Shows  how  to  start  executing  SQL  commands,  create  SQL 
tables  and  views,  and  perform  basic  SQL  database  operations. 

■  Chapter  3  —  Continues  description  of  how  to  use  SQL  commands,  par¬ 
ticularly  the  SELECT  command,  to  perform  simple  queries  of  data  from 
single  tables. 

■  Chapter  4  —  Shows  how  to  perform  more  complex  queries,  including 
joins  and  subqueries  of  data  from  more  than  one  table  at  a  time. 

■  Chapter  5  —  Describes  how  to  effectively  use  dBASE  commands  with 
SQL  statements  in  the  interactive  SQL  environment. 

■  Chapter  6  —  Shows  how  to  embed  SQL  statements  in  program  files; 
demonstrates  more  advanced  features  of  SQL;  shows  how  to  define  and 
use  SQL  commands  in  program  files  to  INSERT,  UPDATE,  or  DELETE 
data. 

■  Chapter  7  —  SQL  command  reference:  provides  syntax,  description,  and 
examples  for  each  command. 

■  Chapter  8  —  Describes  SQL  catalog  tables. 
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.  Four  appendices  are  provided: 

■  Appendix  A  —  Describes  and  lists  SQL  error  messages. 

■  Appendix  B  —  Provides  a  glossary  of  SQL  terms. 

■  Appendix  C  —  Describes  dBASE  commands  and  functions  that  can  be 
used  with  SQL. 

■  Appendix  D  —  Lists  data  in  the  SQL  sample  application  tables: 
Customer,  Staff,  Inventry,  Assembly,  Sales,  and  Items. 


Before  You  Begin 

Before  you  begin,  make  sure  you’ve  installed  dBASE  IV  and  the  associated 
SQL  sample  Hies.  If  you  have  not  already  done  so,  follow  the  instructions  in 
Getting  Started.  If  you’re  installing  dBASE  IV  on  a  local  area  network,  refer 
to  instructions  in  Network  Installation. 
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SQL  Basics 


This  chapter  provides  an  introduction  to  SQL.  It  describes  SQL  database  con¬ 
cepts  and  how  you  can  use  SQL  commands  with  dBASE  IV. 


A  Brief  History  of  SQL 

SQL  (Structured  Query  Language)  was  developed  from  research  conducted 
by  IBM  during  the  mid-1970s.  Since  its  first  commercial  introduction  in 
1979,  SQL  has  been  adopted  by  many  companies  as  a  database  language 
standard  for  both  mainframe  and  minicomputer  environments. 

The  introduction  of  SQL  to  microcomputers  has  meant  that  companies  can 
continue  to  standardize  their  development  of  database  applications.  By  using 
SQL  commands  in  dBASE  IV,  you  can  combine  a  database  language  stan¬ 
dard  for  mainframes  and  minicomputers  with  dBASE,  the  standard  in  micro¬ 
computer  dataoase  system  programs. 


What  is  SQL? 

SQL  (Structured  Query  Language)  is  an  advanced  relational  database 
language.  In  a  relational  database,  the  most  simple  or  the  most  complex  data 
can  be  represented  as  a  single  table  or  a  collection  of  related  tables. 

Representing  data  in  tables  provides  a  familiar  and  easy-to-visualize  way  to 
access  information.  SQL  provides  a  small,  concise  set  of  commands  that 
allow  you  to  define,  display,  and  update  information  in  tables.  You  can 
access  any  information  in  tables,  usually  without  the  need  for  any  program¬ 
ming.  Th"S,  you  may  find  SQL  saves  time  when  you  have  to  perform  com¬ 
plex  queries  or  when  the  information  you  want  to  retrieve  changes 
frequently. 

SQL  Tables 

In  SQL,  each  database  table  can  be  viewed  as  a  collection  of  rows  and  col¬ 
umns.  The  intersection  of  each  row  and  column  position  contains  a  data 
value.  Figure  1-1  is  an  example  of  an  SQL  table. 
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If  you’re  already  familiar  with  dBASE,  you’ll  notice  that  the  terminology  SQL 
uses  is  slightly  different.  In  dBASE  terminology,  rows  in  a  database  table  are 
called  records  and  columns  are  called  fields. 
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Figure  1  -1  An  SQL  table 


SQL  Views 

The  SQL  language  allows  you  to  create  another  type  of  table  called  a  view. 
An  SQL  view  is  a  subset  of  the  rows  and  columns  of  one  or  more  existing 
tables.  A  view  is  often  referred  to  as  a  virtual  table,  since  it  does  not  actually 
contain  data.  Rather,  the  view  reflects  the  data  contained  in  one  or  more 
underlying  or  base  tables  on  which  it  is  built.  Data  displayed  in  a  view  is 
dynamic.  That  is,  if  data  in  one  of  the  underlying  base  tables  changes,  data  in 
corresponding  views  is  also  updated.  Similarly,  if  you  change  the  data  in 
views,  data  in  underlying  tables  is  also  changed. 


Set-Oriented  Data  Access 

Using  SQL  commands,  you  specify  the  data  you  want  from  a  table,  rather 
than  a  procedure  to  retrieve  it.  The  system  determines  the  best  way  to  obtain 
the  data.  This  is  different  fron  many  other  database  languages  that  require 
you  to  know  how  the  data  is  stored  on  your  computer  and  then  also  provide 
the  steps  to  retrieve  it. 


The  SQL  Language 

The  entire  SQL  language  consists  of  less  than  30  commands.  However,  it 
provides  all  the  operations  you  need  to  define  tables  and  views,  and  to  query, 
update,  delete,  or  insert  data  in  them.  SQL  commands  are  easy  to  use  since 
every  SQL  command  refers  to  the  same  elements  —  the  rows  and  columns 
of  a  table  or  view . 

For  example,  you  can  construct  the  following  SQL  query: 
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Figure  1-2  shows  the  result  of  the  query,  also  referred  to  as  a  result  table.  In 
this  example,  the  SELECT  command  retrieves  from  the  Inventry  table  all 
parts  (and  their  descriptions)  where  the  number  on  hand  is  greater  than  50. 
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Figure  1  -2  The  result  table  from  an  SQL  query 


In  this  example,  the  SQL  command  contains  a  SELECT  clause  that  identifies 
the  columns  you  want  to  display.  A  FROM  clause  identifies  the  table  or 
tables  from  which  rows  and  columns  are  selected.  Finally,  the  WHERE 
clause  limits  the  rows  of  the  result  table  to  those  that  satisfy  the  condition 
On_hand  >  SO. 


You  use  the  same  SQL  commands  whether  you  want  to  retrieve  or  update 
the  data  in  a  single  table  or  in  more  than  one  table  at  a  time.  The  same  SQL 
commands  can  be  used  interactively  or  included  in  a  program  file.  When 
used  in  a  program,  a  single  SQL  statement  can  often  replace  a  dozen  or 
more  instructions  needed  in  another  database  language.  Figure  1-3  illustrates 
a  comparison  of  the  SQL  commands  used  to  access  data  from  a  database  ver¬ 
sus  those  required  using  dBASE  commands. 
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Figure  1  -3  Query  comparison  of  SQL  and  dBASE  commands 


Using  SQL  Commands  in  dBASE  IV 

SQL  commands  provide  an  alternative  to  using  dBASE  commands  to  display 
or  access  data.  1116  set  of  commands  you  decide  to  use  to  access  data 
depends  on  your  familiarity  and  experience  with  either  SQL  or  dBASE  lan¬ 
guage  commands. 


Interactive  and  Embedded  SQL  Modes 

In  dBASE  IV,  SQL  commands  can  be  used  interactively  or  in  program  files. 
In  interactive  SQL  mode,  you  execute  commands  one  at  a  time,  and  the 
results  are  displayed  immediately  after  each  command.  This  mode  is  similar 
to  entering  dBASE  commands  at  the  dot  prompt. 

In  embedded  SQL  mode,  you  can  create  dBASE  program  files  that  include 
SQL  commands.  In  mainframes  and  minicomputer  environments,  SQL  is 
typically  used  with  languages  such  as  COBOL,  FORTRAN,  or  C  to  build  a 
database  application  program.  In  dBASE  IV,  you  can  combine  SQL  with 
dBASE  commands. 


Combining  dBASE  Commands  with  SQL 

dBASE  IV  provides  a  full  spectrum  of  commands  that  can  make  using  SQL 
commands,  in  either  interactive  or  embedded  SQL  modes,  easier.  For  exam¬ 
ple,  you  can  use  dBASE  commands  to  create  and  print  reports,  set  up  a 
printer,  and  print  the  results  of  SQL  comm  an ds. 

If  you  want  to  use  SQL  commands  in  embedded  SQL  mode,  dBASE  IV  pro¬ 
vides  commands  to  construct  menus,  design  forms  for  report  and  data  entry, 
and  control  the  operation  of  a  program. 
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Switching  Between  dBASE  and  SQL  Modes 

dBASE  IV  provides  two  basic  modes  in  which  to  enter  commands.  The 
default  mode  allows  you  to  use  only  dBASE  commands;  the  second  mode 
allows  you  to  use  SQL  commands  plus  a  subset  of  dBASE  commands.  You 
need  to  specify  the  SQL  mode  to  use  SQL  commands  because  of  differences 
in  the  way  SQL  and  dBASE  operate,  and  because  certain  SQL  and  dBASE 
commands  and  functions  have  the  same  name  (for  example,  the  SELECT 
command).  However,  you  can  easily  switch  back  and  forth  between  the  two 
modes. 

To  switch  interactively  to  SQL  from  the  dBASE  mode  at  the  dot  prompt,  use 
the  SET  SQL  ON  command.  To  switch  back  again,  use  SET  SQL  OFF.  When 
creating  dBASE  program  files,  you  specify  the  mode  you  want  (dBASE  or 
SQL)  by  the  extension  you  give  to  each  program  file.  Use  .prg  for  dBASE  pro¬ 
gram  files,  and  .prs  for  SQL  program  files.  When  program  files  are  executed, 
dBASE  IV  automatically  switches  modes  depending  on  the  extension  of  the 
current  file. 

In  both  interactive  and  embedded  SQL  modes,  you  cannot  use  a  certain  cate¬ 
gory  of  dBASE  commands  and  functions:  those  that  open  a  database  file  or 
require  a  file  in  use.  In  SQL  mode,  SQL  commands  perform  those  operations 
instead.  (Appendix  C  indicates  the  dBASE  commands  and  functions  that  can 
also  be  used  in  SQL  mode.) 


SQL  Catalogs 


SQL  is  able  to  work  efficiently  by  maintaining  and  referencing  information 
on  each  SQL  table  or  view  that  it  uses.  This  information  is  stored  in  files 
called  catalog  tables.  When  you  create  an  SQL  database  using  the  SQlJCRE- 
ATEj  *- 

C DATABASE  command,  a  set  of  these  catalog  tables  is  automatically  created 
for  that  database.  (See  Chapter  8  for  a  description  of  the  SQL  catalog  tables.) 

To  use  dBASE  database  files,  SQL  provides  a  special  utility  command, 
DBDEFINE.  By  using  this  utility  and  specifying  the  files  you  want  to  use  as 
SQL  tables,  you  create  catalog  table  entries  for  each  database  file.  After  mak¬ 
ing  the  catalog  table  entries,  you  can  use  SOL  or  dBASE  commands  to 
access  data  from  the  database  file. 


dBASE  IV  also  provides  another  command,  RUNSTATS,  that  updates  statis¬ 
tics  maintained  in  the  catalog  tables  for  SQL  tables.  RUNSTATS  should  be 
run  periodically  so  that  SQL  operations  will  continue  to  be  perform~ed|effi- 
ciently. 

Single-User  and  Local  Area  Network  (LAN)  Operation 

dBASE  IV  provides  both  single-user  and  network  SQL  support  for  both  inter¬ 
active  and  embedded  SQL  operation.  SQL  program  files  that  you  create  in 
dBASE  IV  will  automatically  run  on  a  local  area  network. 
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This  means  that  when  more  than  one  user  is  running  dBASE  IV,  data  in 
tables  is  automatically  locked  during  SQL  operations  that  insert,  update,  or 
delete  data.  If  an  operation  cannot  be  performed  because  the  data  is 
currently  in  use,  you  can  instruct  dBASE  IV  to  retry  the  operation  until  it  is 
successful. 
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Starting  SQL 


In  this  chapter,  you’ll  learn  how  to  run  SQL  commands  in  dBASE  IV’s  inter¬ 
active  SQL  mode  to  start  building  and  using  SQL  databases.  The  examples  in 
this  chapter  show  you  how  to  create  and  use  SQL  databases,  tables,  views, 
synonyms,  and  indexes. 


What  This  Chapter  Covers 

The  topics  covered  in  this  chapter  are: 

■  The  Samples  database 

■  Entering  and  exiting  the  SQL  interactive  mode 

■  Entering  and  editing  commands  at  the  SQL  command  line 

■  Creating  and  using  SQL  databases 

*  Creating  and  using  SQL  tables,  views,  synonyms,  and  indexes 
r  SQL  catalog  tables 


Preparing  for  This  Chapter 

This  chapter  assumes  that  you’ve  already  started  dBASE  IV  and  have  the 
dBASE  IV  dot  prompt  displayed  on  your  screen.  Some  examples  in  this 
chapter  use  sample  SQL  tables.  Follow  the  instructions  in  Getting  Started  to 
install  them.  If  you’re  installing  dBASE  IV  on  a  local  area  network,  refer  to 
instructions  in  Network  Installation. 


The  Sample  Database 

When  you  install  dBASE  IV  and  the  associated  SQL  sample  files,  a  sample 
SQL  database  is  created.  The  database  has  a  default  name  of  Samples  and  is 
in  the  directory  named  \DBASE\SAMPLES.  It  contains  the  sample  tables 
used  in  this  chapter  and  remaining  chapters  of  this  book.  The  tables  resem¬ 
ble  those  you  might  create  for  an  application  of  your  own. 
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SQL  Tabl« 

Customer 

Staff 

Inventry 

Assembly 

Sales 

Items 


Description 

Names  and  addresses  of  customers 
Names  and  information  on  employees 

Description,  quantities  on  hand,  and  pricing  for  inventoried 
items 

Simple  subassembly  parts  listing  for  assemblies  listed  in  the 
Inventry  table 

Office  equipment  orders 

Part  number  and  quantity  of  items  corresponding  to  order 
numbers  in  Sales  table 
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Figure  2-1  The  SQL  sample  tables 


The  application  for  which  the  tables  were  designed  is  an  order  entry  and 
invoicing  system,  as  shown  in  Figure  2-1.  Take  a  few  minutes  to  become 
familiar  with  the  names  of  the  tables  and  the  types  of  data  they  contain.  (You 
may  also  want  to  make  a  copy  of  the  table  structures  and  the  data  in  the 
tables  to  reference  as  you  run  samples  in  this  book.  Appendix  D  provides  a 
listing  of  the  contents  of  each  table.) 
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The  SQL  Interactive  Mode 

The  easiest  and  quickest  way  to  start  using  SQL  is  to  execute  commands  in 
dBASE  IV’s  interactive  SQL  mode.  This  mode  will  help  you  quickly  learn 
how  to  use  each  SQL  command.  Th6  interactive  mode  gives  you  immediate 
feedback:  you  enter  an  SQL  command  and  it  displays  a  result.  You  can  also 
ask  for  Help,  which  displays  the  syntax  and  other  useful  information  for  the 
command  you’re  entering. 

The  interactive  SQL  mode  is  also  well  suited  for  experienced  SQL  users  and 
application  developers.  It  is  a  good  tool  to  use  when  you’re  designing,  build¬ 
ing,  and  testing  database  applications.  Also,  since  most  SQL  commands  oper¬ 
ate  the  same  interactively  as  they  do  within  an  application  program,  you  can 
use  nearly  everything  you  do  in  interactive  mode  when  you  build  an  applica¬ 
tion  program.  (Chapter  6  describes  how  you  can  use  SQL  when  creating 
applications.) 


Entering  the  SQL  Interactive  Mode 

To  start  the  interactive  SQL  mode,  enter  the  SET  SQL  ON  command  from 
the  dBASE  dot  prompt.  If  you  are  operating  in  dBASE  IV’s  menu  system,  you 
must  first  exit  from  the  menus  and  display  the  dBASE  dot  prompt. 

.  SET  SOL  CN~ 

The  prompt  displayed  on  your  screen  changes  to  SQL.  to  show  that  you’ve 
entered  the  SQL  interactive  mode.  To  exit  the  interactive  SQL  mode,  enter 
the  command  SET  SQL  OFF. 


NOTE 

Tb  start  up  in  the  interactive  SOL  mode  automatically,  enter 
SQL*  ON  or  COMMAND *  SET  SOL  ON  in  your  Con  fig.  db  Hie. 


Entering  SQL  Commands 


You  can  enter  SQL  statements  directly  on  the  SQL.  prompt  command  line, 
or  press  Ctrl-Home  to  activate  an  editing  window  in  which  to  enter  SQL 
statements.  You  enter  commands  at  the  SQL  dot  prompt  in  the  same  way 
you  enter  commands  at  the  dBASE  dot  prompt. 

Each  SQL  command  or  statement  can  contain  up  to  1,024  characters.  At  the 
SQL.  prompt,  an  SQL  statement  must  be  entered  on  a  single  line.  In  the  edit¬ 
ing  window,  an  SQL  statement  can  be  entered  on  one  or  more  lines.  At  the 
end  of  an  SQL  statement,  you  type  a  semicolon,  and  then  press  ♦♦  to  execute 
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files,  however,  you  may  also  use  a  semicolon  as  a  continuation  char¬ 
acter  when  entering  a  dBASE  command  allowed  in  SOL  mode  ( see 
Appendix  C). 


NOTE 

In  the  interactive  SOL  mode,  semicolons  are  only  used  to  indicate  the 
end  of  a  statement  that  contains  an  SOL  command.  In  SOL  oroeram 


Command  Line  Editing 

While  entering  a  command,  you  can  use  the  navigation  and  editing  keys 
listed  in  Tfcble  2-2.  These  keys  provide  the  same  functions  as  those  provided 
when  entering  dBASE  commands  at  the  dot  prompt. 


Table  2-2  SQL  navigation  and  editing  keys 


Key 


T 

i 

Ctri-*- 
Ctrl— * 
Home 
End 

Backspace 

Dei 

Ins 

Num  Lock 

Caps  Lock 
FI  Help 

Ctrl-Home 

Ctrl-End 


Function 

Moves  cursor  one  character  to  right 
Moves  cursor  one  character  to  left 
Moves  cursor  to  beginning  of  previous  line 
Moves  cursor  to  beginning  of  next  line 
Moves  cursor  to  previous  word  in  command 
Moves  cursor  to  next  word  in  command 
Moves  cursor  to  beginning  of  command  line 
Moves  cursor  to  end  of  command  line 
Deletes  one  character  to  left  of  cursor 
Deletes  one  character  at  cursor  position 

Switches  modes  between  inserting  and  overwriting  charac¬ 
ters 

Tbrns  Numeric  mode  on  and  off  (must  be  off  for  function 
keys  on  numeric  keypad  to  operate) 

Switcher  automatic  upper  case  mode  on  and  off 

Displays  Help  for  command  if  pressed  after  entry  of  SQL 
command  keyword 

Opens  a  full-screen  edit  window 

Closes  a  full-screen  edit  window  and  returns  to  the  SQL 
prompt  command  line 

Executes  the  command  displayed  on  the  command  line. 
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Window  Editing 

When  you  press.  Ctrl-Home,  a  full-screen  editing  window  appears.  Any  por¬ 
tion  of  commands  you  begin  typing  at  the  command  line  will  appear  in  the 
window . 

In  the  editing  window  you  can  enter  SQL  commands  on  more  than  one  line. 

You  may  separate  portions  of  the  same  command  on  different  lines  by  press¬ 
ing  <*♦.  At  the  end  of  an  SQL  statement,  type  a  semicolon.  After  you  finish 
entering  a  command,  pressAOr1-Home  again.  The  command  displays  again  on  KC  \Yl 
a  single  line  at  the  SQL  prompt.  To  execute  the  command,  press 


■PI  ™ 

Use  the  Tab  key  instead  of  the  Spacebar  to  indent  portions  of  an  SOL 
command  entered  on  multiple  lines  in  the  editing  window.  When  you 
return  to  the  SOL  prompt,  each  and  Tab  character  will  be 
condensed  to  a  single  space.  Later,  however,  if  you  return  to  the  edit 
window,  the  command  will  appear  as  you  formatted  it  originally. 


SQL  Command  Syntax 

Each  command  or  SQL  statement  begins  with  a  keyword ,  such  as  INSERT  or 
SELECT,  that  names  the  basic  operation  performed.  Many  SQL  commands 
also  have  one  or  more  keyword  phrases,  or  clauses ,  that  tailor  the  command 
to  meet  a  particular  need.  Each  SQL  command  must  do  two  things: 

1.  Specify  the  data  you’re  interested  in  (a  set  of  rows  in  one  or  more 
tables). 

2.  Indicate  the  action  to  perform  with  the  specified  data. 

For  example,  to  retrieve  data,  the  SQL  command  is: 

SELECT  <  columns > 

FROM  <  tables  > 

[WHERE  <  condition  >  ]...; 

In  this  example,  the  first  clause  is  the  SELECT  clause,  which  identifies  col¬ 
umns  to  appear  in  the  result.  SELECT  is  also  the  name  of  the  command.  The 
second  clause  is  the  FROM  clause,  which  specifies  the  tables  from  which 
rows  and  columns  are  retrieved.  The  third  clause  shown  is  the  optional 
WHERE  clause,  which  limits  the  rows  that  appear  in  the  result  to  those 
matching  a  specified  condition. 

Certain  conventions  used  in  this  manual  to  describe  command  syntax  are 
listed  below: 

1.  Commands  and  keywords  are  shown  in  upper-case  letters.  You  can  enter 
commands  using  upper-  and  lower-case  letters  if  you  wish. 

2.  An  ellipsis  (...)  indicates  that  there  are  additional  optional  clauses  in  the 
SELECT  command  (for  example,  the  ORDER  BY  and  GROUP  BY 
clauses).  The  options  of  the  SELECT  comm  and  are  described  in  further 
detail  in  Chapters  3  and  4. 
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3.  The  []  (square  brackets)  indicate  that  you  may  optionally  enter  the 

enclosed  information,  but  without  typing  the  brackets.  The  <  >  (angle 
brackets)  indicate  that  you  must  enter  the  enclosed  item. 

Before  using  the  SELECT  com m and,  you  must  have  already  selected  an  SQL 
database  that  contains  the  SQL  tables  you  want  to  view.  For  example,  you 
can  choose  the  Samples  SQL  database  by  typing: 

90..  START  DATABASE  Sanples; 


for  example,  S QLDATABAS E -  SAMPLES. 


NOTE 

You  may  specify  a  default  database  that  is  automatically  started  when 
you  enter  SOL  mode  bv  set  tins  SOLDAEABASE  in  vour  Con  fie. db  file. 


Then,  to  display  data  in  the  Inventry  table,  you  can  construct  the  following 
SQL  statement: 

90_.  SELECT  Partio,  Descript,  CnJerd 
FROM  Inventry; 


PARTJO  DESCRIPT  CNJWD 

1001  WCRKSTAHCN-ELECTRCNIC  OFFICE  2 

1002  HCf€  OFFICE  9UITE  2 

1005  EXECUTIVE  9UITE  ENSEMBLE  1 


1029  FILE  OmET-2  DRAWER  145 

In  this  example,  part  numbers,  descriptions,  and  quantities  for  the  entire 
inventory  are  displayed.  The  data  that  appears  on  your  screen  is  called  a 
result  table. 

To  limit  the  rows  that  appear  you  can  include  a  WHERE  clause: 


9Q_.  SELECT  Partopo,  Descript,  ChJard 
FROM  Inwntry 

U-ERE  Location  =  "LOS  ANSELEST; 


PARTJC 

DESCRIPT  CNJWD 

1002 

HO€  OFFICE  SUITE 

2 

1008 

W0RCSTATICN-5TAND 

22 

1(25 

DESK-EXECUTIVE-5  ROOT 

63 

1031 

CHAIR-EXECUTIVE  SWIVEL/TILT 

79 

1CB8 

LAAP-ORAFTING  SWING  ARM 

1<» 

1007 

VC0D  DESK-SINGLE  PEDESTAL 

62 

1013 

CHAIR-MGDETW -PELMATIC 

35 

1032 

FILE  CABINET-4  DRAWER 

71 

1001 

VCRCSTATICN-B^CTRCNIC  OFFICE 

3 

1029 

FILE  CABINET-2  DRAWER 

145 
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In  this  example,  the  SELECT  command  displays  all  inventoried  parts  in  Los 
Angeles  from  the  SQL  Inventry  table.  Figure  2-2  shows  the  rows  and 
columns  selected  using  this  command. 


Figure  2-2  The  SELECT  query 


Command  Keyword  and  Parameter  Description 

The  entry  of  certain  SQL  command  keywords  and  parameters  must  follow 
specific  guidelines.  These  are  described  in  the  following  table. 


Table  2-3  Keyword  and  parameter  entries  in  commands 


Hem 

Description 

table  name 

Follows  DOS  file  naming  rules:  up  to  eight  characters 
long,  the  first  character  must  be  a  letter. 

view  name 

Same  as  table  names. 

synonym 

Same  as  table  names. 

alias  name 

Same  as  table  names. 

index  name 

Same  as  table  names. 

column  name 

Name  of  a  column  in  a  table  or  view.  Up  to  ten  charac¬ 
ters  (letters,  numbers,  and  underscore  characters).  First 
character  must  be  a  letter. 

data  type 

Data  type  of  the  column. 

expression 

A  character  string  (up  to  254  characters),  a  number,  or 
calculated  column. 
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Re-entering  SQL  Commands 

A  memory  buffer  called  history  allows  you  to  recall  previously  entered  com¬ 
mands  and  edit  or  re-execute  them.  Use  the  SET  HISTORY  TO  command  to 
change  the  number  of  commands  stored  in  the  history  buffer.  (The  default  is 
20.)  Use  the  up  and  down  arrow  keys  to  display  commands  stored  in  the  his¬ 
tory  buffer  at  the  SQL  dot  prompt.  The  history  buffer  is  also  controlled  by 
the  set  of  dBASE  commands  listed  in  Table  2-4. 

When  a  command  is  displayed  at  the  SQL  dot  prompt  you  can  press  to 
execute  it,  or  you  can  edit  it  first.  Pressing  Ctrl-Home  displays  the  command 
in  the  full-screen  editing  window.  If  a  command  was  formatted  on  more  than 
one  line,  it  will  appear  in  the  window  as  it  was  originally  entered. 


Table  24 

History  buffer  commands 

Command 

Function 

DISPLAY  HISTORY 

Displays  the  commands  stored  in  the  history  buffer 
and  pauses  at  each  full  screen  of  commands 

LIST  HISTORY 

Lists  the  commands  stored  in  the  history  buffer 
without  pausing 

SET  HISTORY 

ON/ OFF 

Enables  or  disables  capture  of  commands  in  the 
history  buffer 

SET  HISTORY  TO 

Specifies  the  number  of  commands  that  the  history 
buffer  can  capture 

NOTE 

Refer  to  Language  Reference  for  more  information  on  these 
commands. 


2-8 


STARTING  SQL 


PAGE:  9  SESS:  10  Tu«  fl.y  17  11:36:24  1988 
sk2/al  I j obz/CLS_manhat/GRP_manhat/JOB_mansq I /DIV_sqchap2 

Getting  HELP 

While  in  SQL  mode,  you  can  obtain  help  on  using  SQL  commands  and  the 
dBASE  commands  allowed  in  SQL  mode.  To  display  a  list  of  the  SQL  Help 
topics,  you  can  type: 

SQL.  HELP** 


i 

Figure  2-3  Interactive  SQL  screen 

A  Help  box  appears  that  allow?  you  to  select  an  SQL  topic.  To  select  an  item, 
highlight  it  and  press  ♦♦.  You  can  also  select  an  item  by  simply  typing  its  first 
letter.  Pressing  Esc  returns  the  SQL  dot  prompt  display. 

When  a  Help  display  appears,  you  can  press  F4  to  display  additional  screens, 
or  you  can  select  from  the  choices  appearing  along  the  bottom  of  the  Help 
box,  labelled  CONTENTS,  RELATED  TOPICS,  and  PRINT  To  back  up,  you 
can  press  the  F3  key  or  choose  BACKUP  when  it  appears  along  the  bottom 
of  the  help  screen. 

If  you  want  help  on  a  specific  SQL  or  dBASE  command  or  keyword,  you  can 
type  HELP  followed  by  the  name  of  the  command  or  keyword.  For  example, 
if  you  type  help  select,  a  Help  box  describing  the  syntax  of  the  SELECT 
command  appears. 

If  you’ve  begun  entering  a  command  on  the  command  line  but  haven’t 
pressed  yet,  you  can  also  get  help  in  completing  the  command  by  press¬ 
ing  FI  Help.  For  example,  if  you  type  select  and  then  press  FI  Help,  a  Help 
box  appears  that  describes  the  specific  syntax  of  the  SELECT  command. 
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dBASE  IV  provides  help  in  one  other  situation.  If  you  enter  a  command 
incorrectly  and  try  to  execute  it,  dBASE  IV  will  first  display  an  error  box,  as 
shown  in  Figure  2-4. 


Figure  2-4  SQL  error  box 

The  error  box  provides  three  options.  The  first  two  choices,  Cancel  and 
Edit,  allow  you  to  either  clear  the  command  line  or  to  edit  the  command 
that  caused  the  error.  The  third  option,  Help,  displays  the  syntax  of  the  com¬ 
mand  that  caused  the  error,  or  displays  a  list  of  topics  from  which  you  can 
select. 


SQL  Databases 


dBASE  IV  SQL  uses  databases  to  store  all  information  related  to  the  same 

application.  An  SQL  database  contains  the  following  SQL  objects: 

■  Tables  —  The  basic  structure  for  data  in  a  database  (sometimes  called 
base  tables). 

■  Views  —  A  type  of  virtual  table  providing  a  view  of  data  that  consists  of 
selected  rows  and  columns  from  one  or  more  base  tables.  The  view  is 
updated  as  data  in  the  underlying  tables  changes. 

■  Synonyms  —  Alternate  names  for  tables  and  views. 

■  Indexes  —  Adjuncts  to  tables  that  speed  up  data  access  and  queries  and 
help  maintain  database  integrity. 

■  Catalogs  —  Aset  of  tables  in  each  database  that  describes  the  database 
and  its  contents.  (These  are  different  from  dBASE  catalog  files.) 
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Before  you  begin  creating  or  using  SQL  tables,  you  must  create  a.  data/ 
base  or  activate  (open)  an  existing  database.  Each  database  is  assigned  a 
specific  directory  in  which  all  its  tables  and  related  files  are  stored  Aset 
of  catalog  tables  is  also  stored  in  each  database  directory.  These  tables 
keep  track  of  the  definitions  of  tables,  views,  indexes,  and  synonyms. 
They  also  maintain  authorization  and  statistics  for  operations  performed 
on  tables  and  other  files  in  the  same  database. 


A  master  catalog  table,  Sysdbs,  keeps  track  of  all  databases  that  you  or 
other  users  create.  Sysdbs  records  the  name  of  each  database,  its  DOS 
path  location,  the  name  (user  ID  or  log-in  name)  of  the  person  who  cre¬ 
ated  the  database,  and  the  date  the  database  was  created.  The  Sysdbs 
table  is  located  in  the  SQL  Home  directory  (the  directory  in  which  SQL 
system  files  are  installed). 

dBASE  IV  SQL  provides  five  commands  related  to  SQL  databases.  These 
are  CREATE  DATABASE,  SHOW  DATABASE,  START  DATABASE,  STOP 
DATABASE,  and  DROP  DATABASE. 


Creating  a  Database 

The  CREATE  DATABASE  command  creates  a  database.  It  can  only  be  run  in 
interactive  SQL  mode.  The  syntax  of  this  command  is: 

CREATE  DATABASE  [  <  path  >  ]  <  database  name  >  ; 

To  create  a  database  named  Myapp,  you  could  enter  the  following  command: 

9GL.  CREATE  DAT/BASE  fyopp; 


i 


The  system  displays  the  message  Database  MYAPP  created. 

A  subdirectory  of  your  current  directory,  called  Myapp,  is  created.  Aset  of 
catalog  tables  is  created  in  the  Myapp  database  directory  to  keep  track  of  any 
SQL  tables  created  while  this  database  is  open.  Also,  an  entry  is  made  in  the 
Sysdbs  master  catalog  table  to  include  the  name  of  the  database,  your  user 
name  (user  ID),  the  current  date,  and  the  DOS  directory  path  to  the  new 
database. 

When  you  begin  to  create  SQL  tables  of  your  own,  you  can  use  this  database 
or  create  other  databases.  When  you  create  a  database,  it  is  activated  auto¬ 
matically.  Any  previously  active  database  is  closed. 
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NOTE 

1.  Each  database  name  must  be  unique.  The  number  of  databases  you 
can  create  is  limited  only  by  the  number  of  directories  allowed  by 
DOS. 


2.  You  can  specify  an  explicit  DOS  path  (up  to  64  characters) preced¬ 
ing  the  database  name.  Do  not  insert  a  space  between  the  path  and 
the  name  of  the  database. 


3.  If  a  specified  directory  already  exists ,  no  new  directory  is  created. 
Instead,  that  directory  will  be  defined  as  an  SQL  database  and  a 
complete  set  of  catalog  tables  copied  into  it. 


Listing  Current  Databases 

The-SHOW  DATABASE  command  lists  the  names  of  all  current  SQL 
databases. 

SOL.  SHM  DAT/BASE; 

Existing  databases  are: 

ME  CREATOR  CREATED  PATH 

SAMPLES  SYSTEM  09/22/87  C:\D64SE\SAm_ES 

WAPP  RICX  09/25/87  C:\DBASEWAPP 


Activating  a  Database 

The  START  DATABASE  command  activates  an  existing  database.  The  syntax 
for  this  command  is: 

START  DATABASE  <  database  name>  ; 

This  command  can  be  executed  in  both  interactive  and  embedded  SQL 
modes.  After  you  activate  a  database,  all  SQL  commands  you  issue  refer  to 
tables  and  files  in  that  database.  You  must  have  activated  a  database  before 
issuing  any  SQL  statement  that  defines  or  accesses  data,  such  as  CREATE 
TABLE,  INSERT,  or  SELECT. 

You  may  only  have  one  active  database  at  a  time.  If  you  activate  a  database 
with  START  DATABASE,  any  previously  active  database  is  closed.  You  also 
may  explicitly  close  a  database  using  the  STOP  DATABASE  command.  You 
must  STOP  a  database  before  DROPping  it. 


Dropping  (Deleting)  Databases 

The  DROP  DATABASE  command  deletes  a  database.  The  syntax  of  this  com¬ 
mand  is: 

DROP  DATABASE  <  database  name>  ; 

This  command  can  only  be  run  in  interactive  SQL  mode.  Awarning  prompt 
appears  when  you  issue  the  command,  allowing  you  to  cancel  the  operation 
by  pressing  Esc. 
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This  command  deletes  all  SQL  objects  (and  their  associated  dbf  and  mdx 
files),  deletes  the  catalog  table  files  from  the  database  directory,  and  deletes 
the  entry  for  the  database  in  the  Sysdbs  master  catalog  table.  The  database 
directory  is  not  deleted. 

The  DROP  DATABASE  com m and  cannot  drop  an  active  database.  Before 
issuing  this  command,  activate  another  database  or  deactivate  the  database 
with  the  STOP  DATABASE  command. 


k  WARNING 

Be  careful  when  you  use  the  DROP  DATABASE  command,  as  this 
command  will  delete  the  database  and  its  contents.  You  will  not  be 
able  to  recover  the  SQL  tables  or  the  other  files  deleted  in  the7data- 
base.  — 


SQL  Tables 

Tables  are  the  basic  component  of  an  SQL  database.  Before  you  can  manipu¬ 
late  data  in  a  database,  you  need  to  define  how  the  data  is  placed  there. 

dBASE  IV  SQL  provides  different  ways  to  define  tables.  You  use  the  CREATE 
TABLE  command  to  define  the  structure  of  the  table,  and  the  ALTER  TABLE 
command  to  add  columns  to  an  existing  table.  The  INSERT,  DELETE,  and 
UPDATE  commands  allow  you  to  add,  change,  or  remove  data  in  tables. 

dBASE  IV  also  provides  utility  commands  to  add  data  from  or  send  data  to 
non-SQL  files.  The  DBDEFINE  command  allows  you  to  use  database  files 
created  with  dBASE  commands  in  SQL.  The  LOAD  DATA  command  allows 
you  to  import  dBASE  II  and  dBASE  III  files,  data  from  LOTUS®,  MultiPlan® 
and  Visicalc®  spreadsheets,  ASCII  and  delimited  file  formats,  Framework  11™, 
and  RapidFile™.  The  UNLOAD  DATA T0*comm and  exports  SQL  tables  to 
those  same  file  types. 


Creating  Tables 

To  define  a  new  table  in  SQL,  you  use  the  CREATE  TABLE  command.  The 
syntax  of  this  command  is: 

CREATE  TABLE  <  table  name> 

(<  column  name>  <  data  typo 
[,<  column  name>  <  data  typo  ...]); 

Using  this  command,  you  specify  the  name  of  the  table  you  want  to  create 
and  the  individual  columns  within  the  table.  Table  names  must  be  unique 
within  the  same  database. 

You  assign  to  each  column  a  data  type  defining  the  kind  or  type  of  data  a  col¬ 
umn  may  hold.  For  some  data  types  (for  example,  the  character  data  type), 
you  must  also  specify  a  column  width.  The  column  width  is  the  maximum 
number  of  characters  or  digits  allowed  within  a  column. 
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The  data  types  you  can  specify  when  you  create  an  SQL  table  are  listed  in 
Table  2-5. 


Table  2-6  SQL  table  data  types 


Data  Type 

Description 

SMALLINT 

Holds  an  integer  with  up  to  six  digits  (including  sign).  Val¬ 
ues  entered  may  range  from  -^99,999  to  999,999. 

INTEGER 

Holds  an  integer  containing  up  to  11  digits  (including 
sign).  Values  entered  may  range  from  -  9,999,999,999  to 
999,999,999,999. 

DECIMALS  ,y) 

Holds  a  signed  fixed  decimal  point  number  with  x  total 
digits  (including  sign)  and  /  decimal  places  (significant 
digits  to  the  right  of  the  decimal  point),  x  may  range  from 

1  to  19  and  /may  range  from  0  to  18. /cannot  be  greater 
than  x-1.  For  example,  DECIMAL(6,2)  allows  entry  of  an 
unsigned  value  up  to  9999.99  or  signed  values  ranging 
between  —  999.99  and  9999.99. 

NUMERIC(x.y) 

Holds  a  signed  fixed  decimal  point  number  with  x  total 
digits  (including  sign  and  decimal  point)  and  /  decimal 
places  (significant  digits  to  the  right  of  the  decimal  point). 
x  may  range  from  1  to  20  and  /  may  range  from  0  to  18.  / 
cannot  be  greater  than  x-2.  For  example,  NUMERIC(6,2) 
allows  entry  of  an  unsigned  value  up  to  999.99  or  signed 
values  ranging  between  —  99.99  and  999.99. 

FLOAT(x.y) 

Holds  a  signed  floating  point  number  with  x  total  digits 
(including  sign  and  decimal  point)  and^ decimal  places 
(significant  digits  to  the  right  of  the  decimal  point),  x  may 
range  from  1  to  19  and /may  range  from  0  to  18. /can¬ 
not  be  greater  than  x-2.  The  range  of  numbers  you  may 
store  is  0.1  10"  307  toA0.9  10  +  .  A  number  may  be  speci¬ 

fied  using  scientific  (exponential)  notation,  for  example, 

-  9.99  +  L235. 

CHAR(n) 

Holds  a  character  string  of  up  to  n  characters,  n  may 
range  from  1  to  254.  Values  may  be  entered  from  charac¬ 
ter  columns,  character  type  memory  variables,  or  a  char¬ 
acter  string. 

DATE 

Holds  a  date  in  the  format  specified  by  the  SET  DATE  and 
SET  CENTURY  commands.  The  default  format  is 
mm/dd/yy.  Values  are  entered  from  date  columns,  date 
type  memory  variables,  or  date  strings  converted  with  the 
dBASE  CTOD()  function,  for  example,  CTOD(' 02/ 15/86”). 

LOGICAL 

Holds  logical  true  or  false  values.  .T.  represents  a  true 
value  and  F.  represents  a  false  value.  Values  are  entered 
from  dBASE  logical  memory  variables  or  columns,  or  by 
the  constants  .T.,  .t.,  .Y.,  .y.,  .F.,  .f.,  .N.,  and  .n.. 
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Figure  2-5  provides  an  example  of  a  table  containing  a  list  of  employees,  per¬ 
haps  similar  to  one  you  might  already  have  on  paper  or  in  another  database 
file.  This  table  is  the  sample  table  Staff  in  the  Samples  database. 


STAFF  NO 

LASTNAME 

FRSTNAME 

HIREDATE 

LOCATION 

SUPERVISOR 

SALARY 

COMMISSION 

1 

Zambini 

Rick 

02/13/80 

LOS  ANGELES 

0 

6000 

3.0 

3 

Vldoni 

Chary  1 

03/06/80 

NEV  YORK 

0 

3780 

3.0 

4 

Coudray 

Sandy 

06/06/80 

LOS  ANOELES 

1 

6237 

3.0 

6 

Thomas 

Pal 

01/08/81 

NEV  YORK 

3 

3873 

3.0 

8 

Molester 

D*bb>* 

04/12/81 

LOS  ANGELES 

1 

4792 

3.0 

11 

MtcVaal* 

Daloras 

03/03/82 

CHICAGO 

12 

4927 

7  0 

12 

Char  las 

Tad 

02/02/83 

CHICAGO 

0 

3943 

3.0 

13 

Marin 

Mark 

06/03/83 

LOS  ANOELES 

1 

4802 

11.0 

13 

Roddick 

Mary 

02/13/84 

NEV  YORK 

3 

3493 

8.0 

16 

Long 

Nicola 

08/18/84 

NEV  YORK 

3 

3190 

7.0 

19 

Rolf** 

Chock 

09/09/84 

LOS  ANOELES 

1 

4586 

6.0 

20 

Sandars 

Kathy 

03/23/83 

CHICAGO 

12 

3783 

3.0 

Figure  2-5  A  sample  database  table 


To  create  the  structure  for  this  table,  enter  the  following  command.  (If  you 

have  not  already  done  so,  first  type  start  database  Samples  to  activate  the  (  ) 

Samples  database.) 


SGL.  CREATE  TABLE  Staffl 

(Staftio  CHAR(6), 

Lastnams  CHAR  (15), 

Firstname  CHAR(IQ), 

Hiredate  DATE, 

Locaticn  CHAR  (15), 

Supervisor  CHAR  (6), 

Salary  DECmtLGjO), 

Camissicn  DECIMAL  (4, 1)); 


I 


Notice  in  the  example  that  the  command  is  on  multiple  lines.  In  contrast  to 
dBASE  commands,  SQL  statements  can  be  entered  on  multiple  lines  (using 
Ctrl-Home  to  edit  commands  in  a  full-screen  window).  You  enter  a  semicolon 
to  indicate  the  end  of  the  statement. 

The  message  Table  STAFF1  created  appears  after  you  run  the  command  and 
the  table  has  been  created.  The  new  table  contains  eight  columns:  Staff_no, 
Lastname,  Firstname,  Hiredate,  Location,  Supervisor,  Salary,  anlJCom  mis¬ 
sion. 

When  you  create  an  SQL  table,  dBASE  IV  constructs  a  corresponding  dBASE 
database  file.  Database  table  size  limits  are  the  same  as  with  other  database 
files  created  in  dBASE  IV:  255  columns  of  up  to  4,000  bytes. 

Besides  creating  a  dBASE  database  file  when  you  define  a  table,  dBASE  IV 
also  updates  the  database’s  catalog  tables  for  the  new  table  definition.  A 
description  of  the  table  is  entered  in  the  Systabls  table  and  descriptions  of 
columns  are  entered  in  the  Syscols  table. 
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Inserting  Data 

SQL  provides  the  commands  INSERT  and  LOAD  DATAFROM  to  add  new 
rows  to  tables.  Using  the  INSERT  command,  you  can  specify  particular  val¬ 
ues  to  insert  into  the  columns  of  a  table,  or  insert  data  from  specified  rows 
qualified  by  a  SELECT  statement. 

The  syntax  of  the  command  to  INSERT  rows  into  a  table  from  a  list  of  values 

is: 


INSERT  INTO  <  table  name> 

[(<  column  list>  )] 

VALUES  (<  value  list  >  ); 

For  example,  to  add  the  first  row  of  data  (shown  in  Figure  2-5)  to  the  Staffl 
table,  you  would  type: 

SQL.  INSERT  INTO  Staff 1 

VALUES  C  ", Zaitinf ,  "Rick",  CTODC  (2/15/80), 

"LOS  ANGLES’,  ,  600D,  5.0);  A 

A 

A 

The  message  1  row(s)  inserted  appears. 

Notice  that  you  did  not  have  to  enter  a  column  list  in  the  example.  You  can 
omit  the  column  list  if  the  order  of  values  you’ve  entered  is  the  same  as  the 
columns  of  the  table  in  which  the  values  are  to  be  inserted. 

You  do  not  need  to  specify  values  to  be  inserted  for  every  column  in  the 
table.  You  can  specify  a  columns  list  to  indicate  particular  columns  to 
update.  Or,  you  can  specify  a  partial  list  of  values  in  the  same  order  as  col¬ 
umns  in  the  table  for  those  columns  you  want  to  update. 

The  data  type  of  values  must  also  match  that  of  the  column  into  which  the 
data  is  inserted.  To  insert  a  date,  you  need  to  specify  a  date  type  memory 
variable,  or  enter  a  character  string  formatted  as  a  date,  and  then  use  the 
CTOD()  (character-to-date)  conversion  function.  For  logical  data,  you  can 
specify  a  logical  type  memory  variable  or  values  of  .T.  (true)  or  .F.  (false). 

To  insert  data  from  selected  rows  of  an  existing  table,  the  syntax  of  the  com¬ 
mand  is: 

INSERT  INTO  <  table  name> 

[(<  column  list >  )] 

<  SELECT  statement >  ; 

You  might  use  this  second  method  of  inserting  data  if  you  have  an  existing 
file  to  which  you  regularly  append  data  from  an  update  or  transaction  table. 

To  insert  rows,  you  could  type: 


SQL.  INSERT  INTO  Staff  1 
SELECT* 

FROM  Staff  K 

U€RE  Lastname  <p  "Zanbinf; 


11  row(s)  inserted 
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This  INSERT  statement  adds  all  rows  from  the  Staff  table  into  the  new  Staffl 
table  you  created,  except  those  where  the  Lastname  column  contains  the 
name  Zambimf.  The  operator  <  >  specifies  a  “does  not  equal”  condition. 
The  asterisk  (*)  is  a  special  symbol  specifying  that  the  SELECT  clause 
include  all  columns  in  the  Staff  table. 

If  you  now  want  to  see  all  the  rows  in  the  table,  you  can  use  the  SELECT 
command: 

90..  SELECT  * 

FROM  Staffl; 


All  the  rows  and  columns  in  Staffl  will  display.  The  list  of  rows  and  columns 
returned  by  the  SELECT  statement  is  known  as  a  result  table.  It  is  not  a  per¬ 
manent  table  like  one  you  create  with  the  CREATE  TABLE  command.  You 
can,  however,  save  the  result  of  a  SELECT  statement  in  a  dBASE  database 
file  using  the  SELECT  command’s  SAVE  TO  clause,  as  you’ll  learn  in 
Chapter  3. 


Updating  Data 

The  SQL  UPDATE  command  allows  you  to  change  the  values  in  one  or  more 
selected  rows  of  a  table.  The  syntax  of  the  UPDATE  command  is: 

UPDATE  <  table  name> 

SET  <  column  name>  =*  <  expression  > 

[,<  column  name>  =  <  expression  >  ...] 

[<  WHERE  clause >  ]; 

For  example,  perhaps  you  want  to  increase  the  commission  of  all  employees 
hired  before  a  certain  date.  To  update  the  commission  column  in  the  Staffl 
table  for  qualified  rows  (hiredate  before  July  5,  1982),  type: 

SGL.  LPMTF  Staffl 

SET  Cdmissicn  =  (Camissicn  *  1.25) 

U-EFE  Hiredate  <  CVODC 07/05/8?); 

The  message  6  row(s)  updated  appears. 

In  this  example,  the  WHERE  clause  specifies  a  simple  condition.  You  can 
use  the  WHERE  clause  to  qualify  rows  using  a  simple  condition  as  well  as 
more  complex  operations  such  as  SELECT.  Chapters  3  and  4  provide  exam¬ 
ples  for  more  complex  SELECT  statements  and  more  complex  uses  of  the 
UPDATE  command. 


Deleting  Data 

The  SQL  DELETE  command  allows  you  to  delete  selected  rows.  The  syntax 
of  this  command  is: 

DELETE  FROM  <  table  name> 

[WHERE  <  clause  >  ]; 
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For  example,  to  delete  a  row  for  an  employee  who  has  left  your  company, 
you  would  type: 

90..  DELETE  FROM  Staff  1 

U-ERE  Lastrame  =  "Larxf  ; 

The  message  1  row(s)  deleted  appears. 

In  this  example,  the  row  in  which  the  Lastname  column  in  the  Staffl  table 
contained  the  string  "Long”  was  deleted. 


WARNING 

Be  careful  when  you  use  this  command.  If  you  forget  to  specify  the 
WHERE  clause,  all  rows  will  be  deleted  from  your  table.  A  prompt 
appears  when  you  issue  DELETE  without  a  WHERE  clause.  Pressing 
Esc  will  cancel  execution  of  the  command. 


Modifying  Tables 

As  your  database  grows,  you  may  have  to  change  the  structure  of  your  SQL 
tables.  dBASE  IV  SQL  allows  you  to  add  columns  to  an  existing  table,  but 
does  not  allow  you  to  delete  or  modify  them.  You  can,  however,  effectively 
modify  a  table  by  creating  a  new  table  and  copying  rows  from  the  existing 
table  into  the  new  table. 

Adding  New  Columns 

The  ALTER  TABLE  command  allows  you  to  add  one  or  more  new  columns 
to  an  existing  table.  The  syntax  of  this  command  is: 

ALTER  TABLE  <  table  name> 

ADD  (<  column  name >  <  data  typo 
[,<  column  name>  <  data  typo  ...]); 

For  example,  to  add  a  new  13-character  column  to  the  Staffl  table  to  contain 
the  phone  numbers  of  employees,  you  would  type: 

SQL.  ALTER  TABLE  Staff  1 
ADO  (Phone  CHARC1D); 

The  message  Column  PHONE  added  to  table  STAFF1  appears  after  the  col¬ 
umn  has  been  added.  The  column  is  added  to  the  table  after  the  last  existing 
column. 

Restructuring  Tables 

You  can  effectively  modify  an  existing  table  by  creating  a  new  table  and 
copying  rows  from  the  existing  table  into  the  new  one.  First  you  create  a 
new  table  with  the  columns  you  want.  Then  you  copy  the  rows  from  your 
existing  table  into  the  new  table. 
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For  example,  to  modify  the  Staffl  table  so  that  the  Lastname  and  Firstname 
columns  are  combined  into  a  new  column  called  Fullname,  first  create  a 
new  table  named  Staff2  with  the  information  below.  Note  that  the  new^Full- 
name  column  has  the  combined  width  of  the  Lastname  and  Firstname  col¬ 
umns  and  is  the  same  data  type. 


SQL.  CREATE  TABLE  Staff? 

(Staff_po  CHAR  (6), 

FuL  Inarm  CHAR  (25), 

Hi  redate  DATE, 

Salary  DECIMAL®/]), 

Comissicn  DECIMAL  (4,  V); 


The  message  table  STAFF2  created  appears. 

Next,  you  insert  data  from  the  old  Staffl  table  into  the  new  Staff2  table: 

SQL.  INSERT  INTO  Staff2 

SELECT  Staff_no,  (Firstname  *  Lastname), 

Hiredate,  Salary,  Comissicn 
FROM  Staffl; 


The  message  11  Row(s)  Insertedappears. 

The  INSERT  INTO  Staff2  SELECT  statement  inserts  rows  of  the  existing 
Staffl  table  into  the  new  Staff2  table. 


In  this  example,  you  do  not  have  to  specify  column  names  following  the 
INSERT  statement  since  the  order  of  columns  in  the  SELECT  clause  matches 
that  of  the  new  table  Staff2.  Data  from  the  expression  (Firstname  +~]_Lasi- 
name)  is  transferred  to  the  new  Fullname  column  because  of  the  relative 
position  of  the  expression  to  the  Fullname  column  in  the  Staff2  table. 


NOTE 

Any  columns  in  the  new  table  for  which  no  data  is  INSERTkd  is  ini¬ 
tialized  with  a  null  (empty)  character  string  or  zero  (depending  on  the 
data  type  of  each  column).  Date  columns  are  initialized  with  a  blank 
date  string  (" mm/dd/yy" )  and  logical  columns  with  the  value  Kf** 


Dropping  (Deleting)  Tables 

To  delete  a  table  that  is  no  longer  needed,  use  the  DROP  TABLE  command. 
If  you  drop  a  table,  the  data  in  it  is  lost  and  cannot  be  restored.  All  indexes, 
views,  and  synonyms  defined  with  that  table  are  also  dropped. 

For  example,  if  you  decided  you  no  longer  needed  the  Staff2  table,  you 
would  drop  it  by  typing  drop  table  staff2; 

The  message  Ibble  STAFF2  dropped  appears. 
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SQL  Views 

dBASE  IV  SQL  allows  you  to  define  a  special  kind  of  table  called  a  view. 
Views  (or  virtual  tables  as  they  are  sometimes  called)  combine  rows  and  col¬ 
umns  selected  from  one  or  more  tables.  You  can  use  SQL  commands  to 
select  and  display  information  from  a  view  just  as  you  do  with  a  table.  You 
can  also  insert  and  update  information  in  the  underlying  base  tables  of  a 
view  when  the  view  is  only  based  on  columns  from  a  single  table. 

One  difference  between  a  table  and  a  view  is  that  the  view  does  not  contain 
data.  Rather,  the  view  displays  the  data  present  in  the  tables  when  the  view  is 
used.  Thus,  as  information  in  the  tables  changes,  so  does  the  data  that 
appears  in  the  view. 

The  simplest  type  of  view  selects  rows  and  columns  from  a  single  table.  You 
can  build  a  view  for  a  single  table  to  reduce  the  number  of  columns  that  dis¬ 
play,  or  use  a  view  to  restrict  user  access  to  information  in  certain  columns. 
Or,  you  might  create  a  view  that  displays  only  the  rows  that  match  a  selec¬ 
tion  criterion. 

Views  based  on  more  than  one  table  allow  you  to  qualify  rows  using  condi¬ 
tions  comparing  column  values  in  any  of  the  underlying  tables.  Examples  of 
single  and  multiple  table  views  are  shown  in  Figure  2-6. 
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Single  Table  View 


Multiple  Table  View 


S  ALES  T  ABLE  ST  AFF  T  ABLE  CUSTOMER  T  ABLE 


Figure  2-6  SQL  views 


Creating  a  View 

You  create  views  with  the  CREATE  VIEW  command.  The  syntax  of  this  com¬ 
mand  is: 

CREATE  VIEW  <  view  name>  [(<  view  column  list >  )] 

AS  <  SELECT  statement > 

[WITH  CHECK  OPTION]; 
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The  CREATE  VIEW  command  has  three  parts.  The  first  part  names  the  view 
and  optionally  specifies  colum  n  names  in  the  view  table.  If  you  don’t  specify 
column  names,  the  view  will  have  the  column  names  listed  in  the  view’s 
SELECT  statement.  However,  you  must  supply  a  column  name  list  if  any  of 
the  view  columns  are  derived  from  a  dBASE  function  or  other  type  of 
expression. 

The  second  part  of  CREATE  VIEW  contains  the  SELECT  statement  that 
defines  rows  and  columns  from  the  underlying  table(s)  to  be  included  in  the 
view. 

The  third  part  of  CREATE  VIEW,  the  WITH  CHECK  OPTION,  is  optional.  It 
is  used  with  views  that  can  be  updated  and  specifies  that  inserted  rows  or 
updated  rows  be  checked  against  the  view  definition.  If  you  specify  the 
WITH  CHECK  OPTION,  you  ensure  that  no  rows  are  inserted  in  the  view 
that  do  not  match  the  condition  of  a  WHERE  clause  (in  the  SELECT  state¬ 
ment)  that  qualifies  rows  displayed  from  the  view. 

For  example,  to  build  a  view  of  the  StaffJP  table  that  only  includes  rows  for 
employees  in  Los  Angeles  and  the  threeAcolumns  Staff_no,  Lastname,  and 
Hiredate,  you  would  type: 

SGL.  CREATE  VIEW  La 

AS  SELECT  Staffjv,  Lastrame,  Hiredate 
FROM  Staff  1 

UhEFE  Location^"  LOS  ANGELES’; 

The  message  view  LA  created  appears. 

Once  you  create  a  view,  you  can  use  the  SELECT  statement  to  retrieve  rows 
from  the  view.  For  example: 

SGL.  SELECT* 

FROM  LA; 

STAFFJO  LASTNAME  HIREDATE 

1  Zanbini  02/15/80 

4  Qxdray  06/0  V80 

8  McLestec  04/12/81 

13  ferin  06/05/83 

19  tolfes  09/09/84 

The  *  selects  all  columns  from  the  view  to  appear  in  the  result.  Also,  because 
no  WHERE  clause  is  present,  all  rows  specified  in  the  view  definition 
appear. 


Using  Views  to  Restructure  a  Database 

You  can  use  views  to  restructure  the  information  in  a  database  without  creat¬ 
ing  new  tables  to  modify  column  definitions,  or  having  to  create  any  new 
base  tables. 
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For  example,  to  create  a  view  that  combines  the  Lastname  and  Firstname 
columns  of  the  Customer  table  in  a  format  more  acceptable  for  reports,  you 
would  type: 


9GL.  CREATE  VIEW  Atiress 
(FuL  lnam.  City,  State) 

AS  SELECT  Firs  trsnetLastrame,  City,  State 
FROM  Customer; 

In  this  example,  the  Firstname  and  Lastname  columns  are  combined  and 
displayed  as  the  Fullname  column  in  the  view. 

In  a  previous  example,  CREATE  and  INSERT  were  used  for  a  similar  restruc 
turing  of  data.  CREATE  TABLE  was  used  to  create  a  new  table  and  INSERT 
was  used  to  insert  rows  into  the  new  table.  Using  views  to  restructure  data, 
however,  has  some  advantages.  Views  do  not  duplicate  the  data  in  the  exist¬ 
ing  table.  Also,  you  can  develop  several  different  views  on  the  same  table. 
Finally,  when  you  use  a  view,  it  will  reflect  the  most  up-to-date  information 
in  the  tables  on  which  the  view  is  based. 


Constructing  a  View  for  More  than  One  Table 

You  can  create  a  view  that  combines  rows  and  columns  from  more  than  one 
table.  For  example,  to  create  a  view  that  combines  data  from  columns  in  two 
different  tables,  the  Staff  table  and  the  Sales  table,  you  would  type: 


I 


9GL.  CREATE  VIEV  Orders 

(Order_no,  Salejjate,  Seller) 

AS  SELECT  Sales.Order_rD,  Sales.Sale_cbte,  Staff  .Lastname 
FROM  Sales,  Staff 

HERE  Sales.  Staff_ro  =  Staff.  Staftro; 

The  message  view  ORDERS  created  appears 

NOTE 

In  the  example  above,  column  names  are  preceded  by  the  table  name 
from  which  information  is  drawn.  You  need  to  specify  the  table  name 
whenever  it’s  not  dear  where  the  column  information  should  come 
from  (for  example,  when  two  tables  both  have  a  column  with  the  same 
name). 


The  view  you  just  created  combines  columns  from  both  tables,  Staff  and 
Sales.  The  result  lists  the  salesperson’s  last  name  (from  the  Staff  table)  with 
the  order  number  and  date  of  each  sale  from  the  Sales  table. 


USING  dBASE  IV  SQL 


2-23 


JOBNAflE :  PAGE:  24  SESS:  15  Tue  Hay  17  11:36  :  24  1  988 

®tate/d  i  sk2/a I l j  obz/CLS_manhat/GRP_manhat/JOB_mansq l /DI V_sqchap2 

To  see  the  results  of  the  view  you  built,  you  can  type: 


S3..  SELECT  * 

FROM  Orders; 

ORDERJO  SALOA7E  SELLER 

20Q02  09/21  /8 7  McLester 

200CB  09/21/87  Thomas 

20004  09/21/87  Rolfes 

20005  09/21/87  Zanbini 


20024  09/25/87  Charles 

<J1HV5  09/25/87  Vidcni 

20006  09/25/87  Coudray 


This  example  shows  how  quickly  a  request  for  information  can  become  com¬ 
plex.  Yet  a  single  SQL  statement  creates  the  view  that  represents  your 
request  for  data.  Then,  treating  the  view  just  like  a  table,  you  can  use  the 
SELECT  command  to  display  the  results.  You  can  sometimes  insert,  delete, 
and  update  data  using  a  view.  For  information  about  updating  views,  see  the 
entry  for  the  UPDATE  command  in  Chapter  7. 


Dropping  Views 

You  can  continue  to  use  a  view  until  you  drop  (delete)  the  view,  drop  the 
database  the  view  is  in,  or  drop  a  table  used  in  constructing  a  view.  To  drop 
a  view,  you  use  the  DROP  VIEW  command: 

9GL.  DROP  VIEU  Orders; 

The  message  View  ORDERS  dropped  appears. 


Defining  Table  and  View  Synonyms 

Synonyms  are  alternate  names  that  can  be  substituted  for  the  names  of  tables 
and  views  defined  in  SQL.  You  can  substitute  a  synonym  for  the  name  of  a 
base  table  or  view  for  use  with  any  SQL  command.  For  example,  you  can  use 
synonyms  to  simplify  and  shorten  table  entries  when  entering  commands 
that  perform  a  query  or  update. 

For  example,  to  create  a  synonym  for  the  Customer  table,  you  could  type: 

SQL.  CREATE  SYNJM  Cl  FOR  Customer; 

Once  you’ve  defined  a  synonym,  you  can  use  it  to  refer  to  a  table  or  view  in 
the  SELECT  command,  the  CREATE  INDEX  command,  INSERT,  UPDATE, 
DELETE,  and  DROP  commands. 
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NOTE 

Synonyms  may  also  be  used  in  place  of  table  or  view  names  in  the 
DROP  TABLE  and  DROP  VIEW  commands.  Be  careful  to  avoid 
destroying  a  table  or  view  inadvertently. 


To  drop  the  synonym  defined  for  the  Customer  table,  you  would  type: 
SQL.  DROP  SYNONYM  Cl; 


SQL  Indexes 

One  of  the  most  important  features  of  any  database  system  is  the  ability  to 
find  stored  information  quickly.  Indexes  are  one  of  the  tools  thatjdBASE  IV 
SQL  uses  to  find  and  retrieve  data. 

dBASE  IV  SQL  uses  indexes  to  keep  track  of  the  location  of  rows  within  a 
database  table.  Knowing  where  data  is  stored  helps  speed  up  data  retrieval, 
similar  to  the  way  a  book’s  index  helps  you  find  the  pages  where  certain 
words  or  topics  are  located. 

You  build  indexes  to  match  the  order  in  which  you  might  want  to  see  the 
data.  This  is  usually  determined  by  the  SELECT,  ORDER  BY,  and  GROUP  BY 
statements  you  plan  to  execute.  However,  unlike  dBASE,  while  you  can  spec¬ 
ify  the  indexes  you  want  to  create,  you  don’t  specify  which  index  to  use 
when  you  retrieve  data.  dBASE  IV  SQL  automatically  selects  the  most  effi¬ 
cient  index. 


Index  files  can  only  be  built  for  tables,  not  for  views.  However,  when  you 
use  a  view,  dBASE  IV  SQL  is  usually  able  to  use  indexes  based  on  the  tables 
underlying  the  view. 

The  indexes  that  dBASE  IV  SQL  creates  are  defined  as  tags  within  a  dBASE 
.mdx  index  file  with  the  same  name  as  the  SQL  table.  When  you  specify  par¬ 
ticular  columns  on  which  to  build  an  index,  the  index  creates  a  list  of  the 
location  of  rows,  in  the  order  in  which  the  rows  should  appear.  You  can  cre¬ 
ate  up  to  48  different  indexes  for  each  database  table. 

You  can  think  of  an  index  tag  as  a  table  having  two  columns.  The  first  col¬ 
umn  contains  the  values  of  columns  in  the  related  database  table.  The  sec¬ 
ond  column  contains  the  storage  locations  of  the  corresponding  rows7Figure 
2-7  shows  how  an  index  might  appear  for  an  SQL  table. 
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|  INDEX  KEY  * 

RECORD  NUMBER  | 

Aar dv ark 

00005 

Antaatar 

10046 

Calarpillar 

10043 

Dog 

10042 

Hors* 

10023 

• 

• 

• 

• 

• 

Swain 

'  66672" 

Tortolaa 

00002 

TurtW 

10043 

Vatar  buffalo 

00003 

Zabra 

10044 

#The  Index  key  columns  contain  the  values  of  columns  for 
which  the  index  is  created.  Index  key  values  are  arranged 
In  ascending  or  descending  order,  depending  on  whether 
you  specify  the  (the  default)  ASCendlng  or  DESCendlng 
order  when  creating  the  Index. 

Indexes  created  with  the  CREATE  INDEX  command  are 
defined  as  index  tags  within  a  single  .mdx  index  file  having 
the  same  name  as  the  table  on  which  the  index  is  based. 

Figure  2-7  Indexing  a  table 

While  indexes  speed  up  the  retrieval  of  data  from  tables,  they  slow  down  the 
performance  of  updates.  Indexes  also  take  up  disk  space.  When  you  perform 
updates  to  a  database  table,  each  index  based  on  that  table  also  needs  to  be 
updated.  You  should  therefore  try  to  limit  the  indexes  you  create. 

You  should  delete  indexes  if  you  no  longer  need  them,  if  the  table  being 
indexed  is  small,  or  if  you  do  not  access  data  in  the  same  order  as  the  index 
was  built.  Note  that  indexes  are  automatically  dropped  if  you  drop  the  table 
on  which  they  are  based. 


Creating  Indexes 

You  create  indexes  with  the  CREATE  INDEX  command.  The  syntax  of  this 
command  is: 

CREATE  [UNIQUE]  INDEX  <  index  name> 

ON  <  table  name>  (<  column  name>  [ASC/DESC]  [,<  column 
name >  [ASC/DESC]...); 

The  columns  specified  are  the  ones  by  which  rows  in  the  index  are  ordered. 
These  columns  are  called  index  keys.  The  maximum  combined  length 
allowed  for  columns  used  to  create  an  index  key  is  100. 
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The  UNIQUE  keyword  specifies  a  unique  index.  This  means  that  specified 
index  columns  in  each  row  of  a  table  will  contain  unique  values.  When  you 
insert  new  rows  in  the  associated  table,  only  unique  indexed  column  values 
will  be  accepted.  The  unique  index  also  ensures  that  indexed  column  values 
will  remain  unique.  When  you  update  a  database  table,  a  unique  index 
ensures  that  you  do  not  inadvertently  create  duplicate  column  entries. 


create  an  SOL  index,  the  dBASE  database  Hie  associated  with  the 
SOL  table  will  only  be  available  as  a  read-only  file  in  dBASE  mode. 

The  ASC/DESC  keywords  specify  the  order  in  which  rows  will  be  arranged 
by  value  of  the  data  in  the  indexed  column.  Ascending  value  indexes  are  the 
default,  so  you  don’t  have  to  include  the  ASC  keyword.  You  may  create 
indexes  on  all  column  types  except  logical. 

Figure  2-8  shows  a  display  of  the  Customer  database  table,  listing  the  clients 
in  alphabetical  order  by  last  name.  If  a  customer  file  is  large,  you  would 
probably  want  to  create  an  index  ordered  alphabetically  by  last  name.  To 
create  this  index,  you  would  type: 

9GL.  CREATE  IhDEX  Lastname 
CN  Customer  (Lastname); 

The  message  Index  LASTNAME  created  appears. 

SQL  Table  Customer  Table 


NOTE 

Use  unique  indexes  sparingly,  since  they  require  checking  every  row 
you  insert  or  update  against  existing  values  in  the  index.  Also,  if  you 


INDEX  KEY 

RECORD  NUMBER 

Bruvdon 

00019 

C«np6*11 

00010 

Cohort 

00021 

D*)i*l* 

00005 

• 

• 

• 

• 

• 

Thompson 

00014 

Trujillo 

00015 

Tsumo 

00022 

Ymijh 

00018 

Young 

00024 

RECORD  NUMBER 


00001 

00002 

00003 

00004 

00003 


00020 

00021 

00022 

00023 

00024 


Figure  2-8  Indexing  the  Customer  table 

You  can  similarly  define  a  descending  order  index.  You  can  also  build 
indexes  based  on  more  than  one  column  as  long  as  you  do  not  specify  both 
ascending  and  descending  ordered  columns  within  the  same  index. 
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To  create  a  unique  index  to  prevent  entries  of  duplicate  order  numbers  in 
the  Sales  table,  you  could  type: 

SQL.  CREATE  LNLGLC  IhD&  Order  Jto 
CN  Sales  (Order Jto) 

The  index  created  forces  data  values  in  the  Order_No  column  of  the  Sales 
table  to  be  unique.  If  you  try  to  insert  a  new  order  number  duplicating  any 
other  existing  order  number,  it  will  not  be  accepted.  Also,  if  you  update 
order  numbers  in  the  table,  the  index  will  make  sure  that  you  do  not  inad¬ 
vertently  duplicate  existing  order  numbers.  If  you  try  to  create  a  unique 
index  and  the  table  already  contains  duplicate  entries,  an  error  message 
appears. 

Dropping  Indexes 

You  drop  an  index  with  the  DROP  INDEX  command.  For  example,  to 
remove  the  Order_No  index,  type: 

SQL.  DROP  IH)EX  Orderjto; 

The  message  Index  ORDER_ NO  dropped  appears. 


SQL  System  Catalogs 

dBASE  IV  SQL  keeps  track  of  all  SQL  objects  (tables,  views,  synonyms, 
indexes)  in  a  database  using  catalog  tables.  It  also  keeps  track  of  authoriza¬ 
tion  privileges  assigned  to  different  users.  dBASE  IV  SQL  uses  the  informa¬ 
tion  in  the  catalog  tables  when  performing  queries  or  updates.  As  the  size  of 
your  database  becomes  larger,  the  catalog  tables  play  an  increasingly  impor¬ 
tant  role.  dBASE  IV  SQL  uses  the  catalog  information  to  perform  database 
operations  as  fast  and  reliably  as  possible. 

Aset  of  system  catalog  tables  is  constructed  for  each  database  you  create 
with  the  CREATE  DATABASE  command.  There  are  ten  tables  in  each/fcata- 
base  catalog.  (See  Chapter  8  for  a  description  of  the  catalog  tables.)  A  master 
catalog  table,  Sysdbs,  is  located  in  SQL  Home  directory  (the  directory  in 
which  the  SQL  program  files  are  stored).  The  Sysdbs  master  catalog  table 
contains  the  name  of  each  database,  the  log-in  name  (user  ID)  of  the  person 
who  created  it,  the  date  it  was  created,  and  the  full  DOS  path  location  of  the 
database  directory. 

You  can  display  information  from  the  catalog  tables  just  like  any  other  SQL 
table.  For  example,  to  display  all  the  tables  and  views  in  the  current  database 
stored  in  the  Systabls  table,  you  could  type: 

SQL.  SELECT  Throne,  Type 
FROM  systabls; 

This  SELECT  statement  displays  both  tables  and  views  in  the  current^iata- 
base.  The  Type  column  indicates  whether  files  are  tables  (T)  or  views  (V). 
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You  can  display  the  definition  of  columns  within  these  tables  by  querying  the 
Syscols  table.  For  example: 

SDL.  SELECT  Colname,  Col  type.  Col  ten 
FROM  Syscols 
hf£KE  Ttnamf^  CUSTOMER'; 

While  you  can  view  the  contents  of  the  catalog  tables,  you  cannot  normally 
update  them,  unless  you’ve  installed  PROTECT  and  the  SQLDBA superuser 
ID,  and  are  logged  in  as  the  SQLDBA  user.  (See  Chapter  5  for  a  description 
of  how  to  use  PROTECT  for  SQL  operations.) 
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SQL  Queries 


In  this  chapter  you’ll  learn  about  SQL  commands  that  retrieve  data.  Most  of 
these  operations  involve  the  SELECT  command.  The  variations  and  flexibility 
of  the  SELECT  command’s  syntax  allow  you  to  create  single  statements  to 
retrieve,  insert,  update,  and  delete  data.  This  chapter  begins  with  the  simpler 
forms  of  the  SELECT  command  and  progresses  through  more  complex 
examples  that  use  all  the  options  of  the  SELECT  command. 

The  examples  in  this  chapter  show  how  you  can  use  SELECT  to  query  data 
from  single  tables.  In  Chapter  4,  you’ll  learn  how  to  use  the  SELECT  com¬ 
mand  in  operations  combining  data  from  more  than  one  table. 


What  This  Chapter  Covers 

The  topics  covered  in  this  chapter  are: 

■  Entering  simple  queries  and  queries  with  conditions 

■  Defining  and  using  expressions 

■  Using  SQL  aggregate  functions 

■  Using  the  BETWEEN,  IN,  and  LIKE  predicates 

■  Ordering  and  grouping  rows 

■  Combining  queries  with  the  UNION  clause 


Preparing  for  This  Chapter 

The  examples  in  this  chapter  use  SQL  sample  tables  provided  with  dBASE 
IV.  (Refer  to  Appendix  D  in  this  book  for  a  listing  of  the  tables.)  To  run  any 
examples  in  this  chapter,  start  SQL  in  the  interactive  mode  and  activate  the 
Samples  database  with  the  START  DATABASE  command.  (You  may  also  start 
the  Samples  database  by  adding  SQLDATABASE  -  SAMPLES  to  your^Con- 
fig.db  file.)  All  example  results  assume  that  you’re  working  with  an  unmodi¬ 
fied  copy  of  the  SQL  tables  in  the  database.  To  ensure  that  you’re  using  data 
from  the  original  sample  tables,  DROP  the  samples  database  and  then 
re-CREATE  it.  Use  DBSETUP  to  copy  the  original  sample  files  into  th^Sam- 
ples  database  directory. 


Z. 


USING  dBASE  IV  SQL 


3-1 


JOBNAME: 
(Btate/d  i 


PAGE:  2  SESS:  7  Ued  Hay  18  16  :  30:  12  1988 
sk2/al  l  j  obz/CLS_manhat/GRP_pianhat/  JOB_mansq  I  /DIV_sqchap3 

SELECT  Overview 

The  SELECT  command  is  used  in  both  interactive  and  embedded  SQL  modes 
to  retrieve  data.  With  a  single  SELECT  statement,  you  can  instruct  SQL  to 
return  any  set  of  data  from  one  or  more  tables.  The  complete  syntax  of  the 
SQL  command  includes  the  clauses  listed  below.  You  can  combine  these 
clauses  in  the  order  listed  to  form  SQL  queries. 

SELECT  <  clause  > 

FROM  <  clause  > 

[INTO  <  clause  >  ] 

[WHERE  <  clause  >  ] 

[GROUP  BY  <  clause  >  ] 

[HAVING  <  clause  >  ] 

[UNION  subselect...] 

[ORDER  BY  <  clause  >  /FOR  UPDATE  OF  <  clause  >  ] 

[SAVE  TO  TEMP  <  clause  >  ]; 


“Embedding  SOL  Commands 

2.  The  term  subselect  in  the  UNION  clause  refers  to  the  SELECT, 
FROM,  WHERE,  GROUP  BY,  and  HAVING  clauses  ( shown  in  bold 
type  in  the  syntax  listed  above).  A  subselect  can  be  joined  with 
another  SELECT  in  the  UNION  clauscfor  as  a  subquery,  or  can 
appear  in  combination  with  other  commands  such  as  DELETE, 
INSERT,  and  UPDATE. 


NOTE 

1.  The  INTO  and  FOR  UPDATE  OF  clauses  are  used  to  construct 
embedded  SOL  mode  queries  and  are  described  in  Chapter  6, 


Simple  Queries 

The  simplest  form  of  the  SELECT  command  that  displays  specified  columns 
from  a  single  table  is: 

SELECT  <  columns > 

FROM  <  tables  >  ; 

For  example,  to  display  the  Company,  Firstname,  and  Lastname  columns 
from  the  Customer  table,  you  would  type: 

SQL.  SELECT  Copay,  Firstname,  Lastname 
FROM  Customer; 
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The  system  displays  the  result: 


Camay 

LednArd  Desigi  Services 

Firstr^mr 

Ridr-11 

Las  tract 

Leeraref 

Ace  FurrvitLre 

Lisa 

Martin 

Cm  ton  FLmitxre 

Daniel 

Fbllock 

The  Office 

Dcminique 

LeClerc 

Classic  Interiors 

Eric 

Lawscn 

Ccnrercial  Interiors  LTD 

Sancy 

Yang 

In  this  example,  you  specify  in  the  SELECT  clause  the  column  names  to 
appear  in  the  display:  Company,  Firstname,  and  Lastname.  (You  also  dictate 
the  order  in  which  they  appear.)  The  FROM  clause  indicates  that  the 
columns  are  from  the  Customer  table. 

The  output  from  a  SELECT  statement  is  called  a  result  table.  The  result  table 
is  not  like  other  tables  you  create.  It  is  not  stored,  nor  can  you  reference  the 
table  after  the  SELECT  statement  has  finished  executing.  You  can,  however, 
use  the  SAVE  TO  TEMP  clause  to  save  the  result  table  as  a  temporary  SQL 
table  to  use  during  the  current  session.  You  can  also  save  the  result  table  as 
a  dBASE  database  file  with  the  KEEP  option. 

Selecting  All  Columns 

SQL  allows  you  to  include  a  special  symbol,  the  asterisk  (•),  in  a  SELECT 
statement  as  a  shorthand  method  of  selecting  all  columns  in  a  table. 

SQL.  SELHT  * 

FROM  Staff; 


would  display  the  result: 


STAFFJO 

LASINffE 

FIRSTNWC 

HI  REDATE 

LOCATICN 

RFER/ISOR 

SALARf 

CCWISSICM 

1 

Zarbini 

Rick 

02/15/80 

LOS  ANGELES 

0 

600D 

5.0 

3 

Vidcni 

Cheryl 

03/06/80 

NEW  TOR< 

0 

5780 

5.0 

4 

Ccufray 

Sandy 

06/06/80 

LOS  ANGELES 

1 

6Z37 

5.0 

6 

Them 

Pht 

01/08/81 

l€WT0RC 

3 

5875 

5.0 

8 

McLester 

Defcbie 

04/12/81 

LOS  ANGELES 

1 

4752 

5.0 

11 

Michaels 

Delores 

05/05/82 

CHICAGO 

12 

4927 

7.0 

12 

Charles 

Ted 

02/02/83 

CHICAGO 

0 

3945 

5.0 

13 

Mr  in 

fcrk 

06/05/83 

LOS  ANGELES 

1 

4802 

11.0 

15 

Roddick 

Miry 

02/13/84 

fEW  YQRC 

3 

5495 

8.0 

16 

Long 

Nicole 

08/18/84 

NEW  YORK 

3 

5190 

7.0 

19 

Rolfes 

Chuck 

09/09/84 

IOS  ANGELES 

1 

4586 

6.0 

2D 

Sanders 

Kathy 

03/23/85 

CHICAGO 

12 

3783 

5.0 

In  this  example,  the  asterisk  indicates  that  all  columns  appear  in  the  result 
table  in  the  order  in  which  you  created  them  in  the  SQL  table. 
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SELECT  with  DISTINCT 


The  sample  Inventry  table  contains  a  combined  inventory  of  items  stored  in 
three  different  locations:  Chicago,  Los  Angeles,  and  New  York.  Typing 
SELECT  *  FROM  Inventry  would  display  listings  of  the  same  part  number  for 
each  location  stocking  it.  To  display  only  distinct  rows  within  a  table,  you 
use  the  £?/S727VCrkeyword  in  the  SELECT  clause.  For  example,  to  display 
each  part  number  in  the  Inventry  table  only  once,  you  could  type: 


9GL.  SB-BCT  DISTINCT  FbrUv,  Descript 
FROM  IrMBitry; 


The  system  would  display  the  result: 


PARTJO 

1001 

1002 

1005 


10S8 


DESCRIPT 

WRCSTATICN-BECTRCNIC  OFFICE 
HCfC  OFFICE  SUITE 
FEXECTIVE  SUITE  ENSEMBLE 
WOOD  DE3C-SIN5LE  PEDESTAL/T) 


CHAIR-TRADITIONAL  ARM 
UW-€RAFTING  SUIN3  ARM 


© 


J 


The  display  now  shows  each  part  number  only  once.  Figure  3-1  shows  how 
rows  with  DISTINCT  column  values  are  selected  from  the  Inventry  table. 


Inventry  Table 
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SELECT  with  a  WHERE  Clause 


So  far,  the  examples  have  described  options  of  the  SELECT  clause  used  to 
pick  columns  displayed  in  a  query.  Sometimes,  though,  you’ll  want  to  specify 
or  qualify  the  rows  that  appear  in  a  query  by  specifying  a  condition  in  the 
WHERE  clause.  The  syntax  then  becomes: 


SELECT  <  columns> 
FROM  <  tables  > 
WHERE  <  condition  >  ; 


Using  the  sample  Inventry  table,  you  can  construct  a  query  to  display  the 
parts  kept  at  any  single  location.  For  example,  to  list  all  the  parts  stocked  in 
Chicago,  you  can  type: 


SDL.  SELECT  Rartlt),  Descript,  ChJsrd 
FROM  Inventry 

U€RE  Lxxatkn  =  0 CWCAOJ ; 


P/WTJO  DESCRIPT 

UXATICN 

CNLHAM) 

10D1  WDRGTAnCN-aBrmCNIC  OFFICE 

CHICAGO 

2 

1005  EXECUTING  SUITE  ENSEMBLE 

CHICAGO 

1 

1009  CHAIR-ADJUSTABLE  SfcffVB. 

CHICAGO 

124 

1024  LANP-BRASS  T/OE 

CHICAGO 

140 

1032  FILE  CABINET-4  DRAWER 

CHICAGO 

15 

103  Q4AIR-TRADITICNAL  ARM 

CHICAGO 

20 

1007  WOOD  DESK-SINGLE  PEDESTAL 

CHICAGO 

35 

1013  (HAIR-MODEBN  PELMATIC 

CHICAGO 

115 

1038  LAfP-ORAFTING  SWING  ARM 

CHICAGO 

89 

1027  DESK-EXECUnVE-6  FOOT 

CHICAGO 

20 

1031  OiAUMDECUnVE  SfliH/TILT 

CHICAGO 

44 

In  this  example,  the  SELECT  clause  identifies  the  columns  to  appear  on  the 
display,  and  the  FROM  clause  identifies  the  Inventry  table.  The  line  contain* 
ing  the  WHERE  clause  specifies  a  search  condition  (Location  - 
'CHICAGO').  The  search  condition  defines  a  criterion  that  selected  rows 
must  meet.  The  equals  operator  compares  the  value  of  the  column  in  the 
specified  condition  with  the  value  you  specify.  Figure  3-2  shows  the  selection 
of  rows  from  the  Inventry  table. 
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Figure  3-2  Selection  of  rows 


When  the  SELECT  statement  has  a  WHERE  clause,  SQL  uses  the  search  con¬ 
dition  to  test  each  row.  When  the  search  condition  is  true,  the  row  is 
selected  and  included  in  the  result  table.  When  the  search  condition  is  false, 
the  row  is  ignored  and  is  not  included  in  the  result  table.  When  specifying  a 
search  condition,  the  columns  included  in  the  condition  can  be  different 
from  those  specified  in  the  SELECT  clause. 

Comparison  Operators 

SQL  provides  several  operators  you  can  use  to  define  search  conditions. 
These  operators  are  listed  in  Table  3-1. 


Table  3-1  Compare  on  operators 


Operator 

Description 

- 

Equals 

< 

Less  than 

> 

Greater  than 

<  = 

Less  than  or  equal  to 

>  = 

Greater  than  or  equal  to 

<  >  or  # 

Not  equals 

■r 

Negation  of  <  ,  >  ,  and  -  comparison  operators,  for 
example,  !<  ,!>  ,or  !- 
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The  two  values  being  compared  must  be  of  compatible  data  types  (character 
to  character,  numeric  to  numeric,  and  so  onJiHowever,  data  types 
SMALLINT,  INTEGER,  DECIMAL,  NUMERIC,  and  FLOAT  are  all  compatible 
with  each  other. 

You  must  enclose  character  type  constants  in  either  single  or  double  quotes. 
Also,  comparisons  on  character  data  types  are  done  differently  than,  say, 
comparisons  on  date  or  numeric  data  types.  Comparisons  of  character  data 
types  use  the  ASCII  representation  of  characters  or  letters.  Thus,  when  you 
do  a  comparison  on  character  types,  the  result  of  the  comparison  depends 
on  whether  characters  are  in  upper  or  lower  case.  That  is,  the  letter  a  is  not 
equal  to  A  A  is  less  than  a  and  Zis  also  less  than  a. 


NOTE 

1.  Logical  data  type  columns  can  be  specified  in  a  WHERE  clause 
both  with  a  comparison  operator  or  without  one.  For  example,  if 
Shipped  is  a  logical  data  type  column,  you  could  construct  the 
following  equivalent  queries: 


SELECT  0  FROM  Orders  WHERE  SHIPPED  =  .  T.; 
SELECT  0  FROM  Orders  WHERE  Shipped; 


2.  You  can  also  use  dBASE  functions  to  convert  column  data  type 
values  in  a  WHERE  clause  search  condition.  For  example,  you  can 
use  the  UPPER()  function  to  convert  characters  to  upper  case,  or 
use  the  CTOD()  function  to  convert  a  date  string  to  compare  with  a 
date  column.  (See  Appendix  C  for  a  list  of  functions  you  can  use 
with  SQL  commands.) 


Combining  Conditions 

You  can  combine  search  conditions  in  a  WHERE  clause.  For  example,  if  you 
wanted  to  find  only  the  parts  stocked  in  Los  Angeles  of  which  you  have 
fewer  than  20,  you  would  enter: 


9GL.  SSECT  Partiv,  Descript,  QxJwrd,  Location 
FROM  IrMontry 

kfERE  Location  -  'LOS  NEELES’  JN)  ChJiand  <20; 

PmjC  DESCRIPT  CNJM)  LOCATION 

1002  HOPE  OFFICE  SUITE  2  LOS  ANSELES 

1CD1  UDRCSTATIChhEECmCNIC  OFFICE  3  LOS  ANSELES 


USING  dBASE  IV  SQL 


J08NAHE:  PAGE:  8  SESS:  8  Ued  Hay  18  16  :  30:  12  1  988 

«t  at  e/di  sk2/al  I  j  ot>z/CLS_dianhat/GRP_manhat/  JOBjnansq  I  /DI  V_sqchap3 

The  result  shows  only  those  inventory  items  that  match  both  conditions  in 
the  WHERE  clause.  SQL  supports  three  different  operators  for  logically  com¬ 
bining  search  conditions.  These  connecting  operators  are  listed  in  order  of 
precedence  in  Thble  3-2. 


Table  3-2  SQL  logical  operators 


Operator 

NOT 

AND 

OR 


Description 

Selects  rows  to  include  in  the  result  table  that  do  not  meet  the 
condition 

Both  conditions  must  be  true  to  qualify  the  row 
One  or  both  of  the  conditions  must  be  true 


When  you  have  multiple  conditions  in  a  WHERE  clause,  the  individual  con¬ 
ditions  are  evaluated  and  then  combined  with  the  logical  operators  to  come 
up  with  a  single  result,  true  or  false.  This  final  evaluation  determines 
whether  a  row  is  included  in  the  result  table. 

The  precedence  of  the  logical  operators  dictates  the  order  in  which  condi¬ 
tions  in  the  WHERE  clause  are  evaluated  and  combined.  As  listed  in  Table 
3-2,  the  NOT  operator  has  highest  precedence,  followed  by  AND,  and  then 
OR.  If,  for  example,  a  WHERE  clause  contains  multiple  conditions  combined 
using  the  same  type  of  logical  operator,  the  conditions  are  simply  evaluated 
left  to  right. 

Parentheses  can  be  used  to  clarify  or  override  the  order  in  which  conditions 
are  evaluated.  Sometimes  you  may  have  to  include  parentheses  to  get  the 
result  you  want. 

For  example,  suppose  you  wanted  to  expand  the  conditions  in  the  previous 
example  to  include  inventory  in  Los  Angeles  or  New  York,  and  in  both  cases 
exclude  items  in  short  supply  if  they  cost  less  than  $1,000.  You  might  type 
the  following: 

SQL.  SELECT  Rartio,  Descript,  Location,  ChJiend,  Lhitcost 
FFDM  In/entry 

UEFE  Location  -  "LOS  ANSELES"  CR  Location  =  ’NU  YCRC 
AN)  Cftjvrd  <20  AN)  Lhitcost  <1000; 


PARTJG 

DESCRIPT 

LOCATION 

GN-HAN) 

LNITCOST 

102 

KJC  OFFICE  SUITE 

LOS  ANGELES 

2 

1395.49 

10DB 

WORCSTATICN-STAM) 

LOS  ANGELES 

22 

275.66 

1015 

CREDENZA-QAK  SLIDING  DOOR 

NBrf  TCRC 

15 

745.00 

1(22 

TABLE-V1ALNJT  OCCASIONAL 

NBJ  Y0RC 

5 

414.95 

1GB2 

FILE  CABIF'ET-4  DRAWER 

LOS  ANGELES 

71 

134.69 

1001 

UORCSTATICN-B_BCTRCNIC  OFFICE 

LOS  ANGELES 

3 

1295.29 

1(29 

FILE  CABIhET-2  DRAWER 

LOS  ANGELES 

145 

89.95 
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You  can  see  that  the  result  is  not  what  you  intended.  As  it  turns  out,  SQL 
first  evaluates  Location  -  'NEW  YORK'  AND  On_  hand  <  20,  then  evalu¬ 
ates  the  AND  expression  Unitcost  <  1000,  and  finally  evaluates  the  OR 
expression  Location  -  'LOS  ANGELES' 

To  get  the  results  you  wanted,  retype  the  command  (or  press  |  to  display  the 
last  command  and  edit  the  SELECT  statement)  to  include  the  parentheses. 


I 


9GL.  SELECT  tkrtso,  Descript,  Location,  Qr\J)arxi,  Lhitcost 
FROM  Infantry 

U€RE  (Location  *  'LOS  AN3ELES"  OR  Location  =  "SEU  YORC) 
AN)  (CtLhard  <20  AND  Lhitoast  <10000; 


f¥RTJD  DESCRJPT 

1015  CRED&&HXK  SLIDING  DOOR 
1022  TABLE-VALNJT  OCCASIONAL 


LOCATION 

NEU 

ha  YOK 


(KHAN)  LNITCOST 
15  745.  CD 

5  414.95y 


Now,  you  see  the  results  you  wanted.  First  SQL  evaluates  the  expression 
(Location  -  'LOS  ANGELES'  OR  Location  -  'NEW  YORK').  Then  it  eval¬ 
uates  the  expression  (On_hand  <  20  AND  Unitcost  <  1000).  Finally,  it 
checks  the  result  of  the  two  separate  expressions  to  determine  whether  the 
row  is  included  in  the  result. 


Defining  and  Using  Expressions 

Expressions  are  statements  like  those  found  in  the  WHERE  clauses  shown 
previously.  For  example,  *LOS  ANGELES*  is  a  constant-valued  expression 
and  Unitcost*10  is  a  variable  expression.  When  evaluated,  an  expression 
always  returns  a  single  value,  that  is,  a  condition  (true  or  false),  a  numeric 
value,  or  a  character  string. 

An  expression  may  contain  a  combination  of  columns,  arithmetic  operators 
(+  ,  —  and  A),  constants  (numeric,  logical,  and  character),  memory 

variables,  and  dBASE  functions.  Expressions  you  can  define  and  use  in  SQL 
are  similar  to  those  you  can  define  and  use  with  dBASE  commands.  Table 
3-3  lists  the  arithmetic  operators  you  can  use  with  SQL.  Figure  3-3  shows  all 
the  elements  you  can  use  in  constructing  an  expression. 


I 


Table  3-3  Arithmetic  operators 


Operator  Description 

•*  and  A  Exponentiation 

+  and  —  Unary  operator  (plus  is  the  default;  minus  for  negative  values) 

*  and  /  Multiplication/division 

+  and  —  Addition/subtraction 
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You  can  use  all  these  operators  with  numeric  values.  Only  the  addition  and 
subtraction  operators  can  be  used  with  character  strings  (for  concatenation). 


Expressions  can  be  included  in  SELECT  statements  to  change  the  resulting 
display.  Some  of  the  other  ways  you  can  use  expressions  with  dBASE  IV  SQL 
statements  are  listed  below. 

■  To  insert  descriptive  column  information  into  a  SELECT  result  table 

■  To  define  new  calculated  columns  in  the  SELECT  clause 

■  To  define  conditions  in  a  WHERE  clause 

■  To  define  expressions  for  the  HAVING  clause 


Expressions  in  the  SELECT  Clause 

There  are  two  different  ways  you  can  use  expressions  in  the  SELECT  clause. 
The  first  lets  you  insert  descriptive  column  information  next  to  the  columns 
displayed  by  a  SELECT  statement. 
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The  second  way  to  use  expressions  in  the  SELECT  clause  is  to  define  a  new 
column,  known  as  a  calculated  column.  This  column  does  not  exist  in  the 
SQL  table  but  may  be  based  in  some  way  on  existing  columns.  Instead  of  the 
column  from  the  SQL  table  appearing  in  the  result  table,  an  expression  that 
defines  the  new  colum  n  appears.  For  exam  pie,  if  you  wanted  to  display 
employee  salaries  per  year  instead  of  per  month,  you  could  type: 

SQL.  SBEJ  Staff _no,  Firstnam,  Lastname, > 

Salary*12,  '  (Yearly  Salary? 

FROM  Staff; 

STAFFJD  FIRSTNAPt 
1  Rick 

3  Cheryl 

4  Sandy 
6  Rat 
8  Debbie 

11  Delores 

12  Ted 

13  Iterk 

15  Huy 

16  Nicole 

19  Chuck 

2D  Kathy 


LASTNAPE  SALARY12  *  (Yearly  Salary)" 

Zanbini  72DDD  (Yearly  Salary) 

Vidbni  60350  (Yearly  Salary) 

Coudray  74864  (Yearly  Salary) 

Thoms  7U300  (Yearly  Salary) 

McLester  573D4  (Yearly  Salary) 

Michaels  39124  (Yearly  Salary) 

Charles  71340  (Yearly  Salary) 

Pterin  57624  (Yearly  Salary) 

Roddick  65916  (Yearly  Salary) 

Lcng  6228D  (Yearly  Salary) 

Rolfes  55032  (Yearly  Salary) 

Sanders  45396  (Yearly  Salary) 


A  calculated  column  appears  in  the  result  table  according  to  the  order  in 
which  columns  or  calculated  columns  are  listed  in  the  SELECT  clause. 


Expressions  in  the  WHERE  clause 


| 


Conditions  specified  in  the  WHERE  clause  (and  the  predicates  BETWEEN, 
IN,  and  LIKE)  may  use  expressions.  These  expressions  evaluate  to  a  logical 
true  or  false  value.  You  can  use  logical  operators  to  combine  several  condi¬ 
tions.  This  is  illustrated  by  the  SELECT  statement  shown  below. 


Urv*  sp, 


SQL.  SELECT  RtrtLDO,  Descript,  Location,  CnJend 
FROM  Inentry 

UCRE  Location  =  'UOS  /NSELEST  FND  CnJand  <  75; 


PART_N0 

DESCRIPT 

UXATICN 

GUV*© 

1DD2 

HCP€  OFFICE  SUITE 

LOS  ANG&ES 

2 

1GD8 

UDRCSTATICN-STAPI) 

LOS  ANGELES 

22 

1025 

0E9(-eccunvE-5  FOOT 

LOS  ANGELES 

63 

1007 

WOOD  DESK-SINGLE  PEDESTAL 

LOS  ANGELES 

62 

1013 

CHAIR-PCOEHN  RCLMTIC 

LOS  ANGELES 

35 

1032 

FILE  CABINET-4  DRflER 

LOS  ANGELES 

71 

10D1 

VOKSTATICN-BLECTRCNIC  OFFICE 

LOS  ANGELES 

3 

In  this  example,  the  character  column  Location  is  compared  with  a  simple 
character-string  constant,  and  the  numeric  column  On.hand  is  compared 
with  a  simple  numeric  constant. 
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dBASE  IV  SQL  allows  you  to  include  more  complex  expressions  in  the 
WHERE  clause  just  as  you  can  in  the  SELECT  clause.  These  can  further 
qualify  the  data  displayed  by  a  SELECT  statement.  You  can  perform  calcula¬ 
tions  in  specifying  a  condition,  and  also  specify  comparisons  based  on  the 
values  of  more  than  one  column. 

For  example,  to  display  employees  from  the  staff  whose  annual  salary  is 
more  than  $50,000,  you  could  type  the  following  query: 


9GL.  SELECT  Staff jyo,  Firstreme,  Lastname >  Salary*12 
FROM  Staff 

U€FE  Salary*12  >  50000; 


STAFFJO  FIRSTNAfC 

LASTNAfC 

SALARW2 

1  Rick 

Zanbini 

72000 

3  Cheryl. 

Vidcni 

69360 

4  Sandy 

Ccuckay 

74844 

6  Pat 

Thoras 

70500 

4  Sandy 

Coudray 

74844 

8  Debbie 

McLester 

57504 

11  Delores 

Michaels 

39124 

12  Ted 

Charles 

71340 

13  terk 

ter  in 

57624 

15  tery 

Roddick 

65916 

16  Nioole 

Lcng 

Rolfes 

F?7fC\ 

19  Chuck 

55032 

This  comparison  could  also  be  made  using  a  memory  variable.  That  way,  you 
could  write  a  single  SELECT  statement  that  would  provide  different  results 
based  on  the  value  in  the  memory  variable.  If  you  assigned  the  memory  vari¬ 
able  msalary  a  numeric  value  of  50,000,  you  could  type: 

9GL.  SELECT  Staff _no,  Firstrame,  Lastname,  Salary*12 
FROM  Staff 

UEFE  Salary*12  >  msalary; 


IPS  TIP 

This  technique  of  us  hg  memory  variables  to  influence  the  result  of  a 
Wtkm  SELECT  statement  is  most  useful  in  programs.  You  ’ll  learn  more 
about  using  dBASE  memory  variables  with  SQL  in  Chapter  6. 


Using  dBASE  Functions 

Besides  using  constants,  column  values,  and  arithmetic  operators  in  expres¬ 
sions,  you  can  also  use  dBASE  functions.  dBASE  IV  provides  over  100  func¬ 
tions  that  can  be  used  with  SQL  (see  Appendix  Q. 
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As  an  example,  you  could  use  the  dBASE  DATE()  function  to  display  all 
employees  in  the  Staff  table  employed  for  longer  than  five  years  from  the 
current  date  (October  1,  1987).  You  would  type: 

9GL.  SBICT  Firstrame,  Lastrane,  Hiredate 
FROM  Staff 

U€RE  (DATEO-b  irachteJ  >365*5; 


FIRSTN#€ 

LASINAfC 

HIREDATE 

Rick 

Zarbini 

CE/15/80 

Cheryl 

Vicfcni 

□5/06/80 

Sandy 

Couiray 

06/06/80 

Pat 

Thcmas 

01/08/81 

Defcbie 

McLKter 

04/12/81 

Delores 

Michaels 

06/05/82 

The  expression  (DATE(}-hiredate)  calculates  the  number  of  days  since  an 
employee  was  hired. 

dBASE  functions  are  also  useful  in  defining  character-string  comparisons. 
dBASE  IV  provides  such  functions  as  UPPER(),  LOWER(),  and  SUBSTRQ,  to 
name  a  few.  (See  Appendix  C  for  a  complete  list  of  dBASE  functions  that  can 
be  used  with  SQL.)  For  example,  to  locate  all  customers  in  the  Customer 
table  who  live  in  San  Francisco,  you  might  construct  the  following  query: 


9GL.  SSJCT  Ccnpary,  City,  State 
FROM  dstomer 

U€RE  LPPER(City)  =  "SAN  FRANCISOCT; 


CCMP/NT 

CITY 

STATE 

Black's  FLmitxre  Store 

San  Francisco 

CA 

A1  Office  Sipply  Store 

San  Francisco 

CA 

Cohen’s  FumitLre 

San  Francisco 

CA 

With  this  query,  the  dBASE  UPPER()  function  transforms  values  from  col¬ 
umns  in  the  Customer  table.  The  columns  in  the  Customer  table  will  match 
even  if  the  characters  were  entered  in  upper  and  lower  case. 

SCX  Aggregate  Functions 

Besides  the  functions  that  the  dBASE  language  provides,  SQL  provides  five 
special  functions  called  aggregate  functions  that  can  be  used  with  the 
SELECT  command.  These  are: 

■  COUNTQ  —  Counts  the  number  of  rows  selected 

■  SUM()  —  Sums  the  values  of  a  numeric  column 

■  MIN()  —  Finds  the  minimum  value  of  a  character  or  numeric  column 

■  MAX()  —  Finds  the  maximum  value  of  a  character  or  numeric  column 

■  AVG()  —  Calculates  the  average  of  the  values  in  a  numeric  column 
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NOTE 

When  the  \ON()  and  MAX()  functions  are  used  with  character  column 
arguments,  they  return  column  values  with  the  lowest  and  highest 
character  constant  values,  respectively.  ASCII  character  values  in 
each  column  are  compared  starting  with  the  first  character  on  the  left. 

The  two  values  being  compared  must  be  of  compatible  data  types,  character 
to  character,  numeric  to  numeric,  and  so  on.  However,  data  types 
SMALLINT,  INTEGER,  DECIMAL,  NUMERIC,  and  FLOAT  are  all  compatible 
with  each  other?«Character  type  constants  must  be  enclosed  in  either  single 
or  double  quotes.  Also,  comparisons  on  character  data  types  are  done  differ¬ 
ently  than,  say,  comparisons  on  date  or  numeric  data  types.  Comparisons  of 
character  data  types  use  the  ASCII  representation  of  characters  or  letters. 
Thus,  when  you  do  a  comparison  on  character  types,  the  result  of  the  com¬ 
parison  depends  on  whether  characters  are  in  upper  or  lower  case.  That  is, 
the  letter  a  is  not  equal  to  A  A  is  less  than  a  and  Zis  also  less  than  a. 

The  aggregate  functions  operate  on  all  the  values  of  a  column  (or  all 
columns)  in  a  table,  view,  or  intermediate  result  table,  or  values  based  on  a 
group  of  rows  qualified  by  a  GROUP  BY  or  HAVING  clause.  This  differs  from 
the  operation  of  dBASE  functions  allowed  in  SQL  mode,  which  operate  on 
the  value  of  a  single  column.  Figure  3-4  shows  how  you  can  use  the  SQL 
functions  and  illustrates  the  arguments  you  can  supply  to  them. 


Only  expressions  including  a  column  name  can  be  used  as  arguments  to  the 
SQL  functions.  You  cannot  use  a  constant  or  memory  variable  as  an  argu¬ 
ment  to  an  SQL  function  .Specifying  DISTINCT  with  an  SQL  function  pre¬ 
vents  duplicate  values  witnin  a  table  or  group  of  rows  from  being  used  in  the 
evaluation  of  the  function's  result. 
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Using  Aggregate  Functions  in  a  SELECT  Clause 

Aggregate  functions  can  be  used  in  place  of  a  column  name  in  the  SELECT 
clause.  They  operate  on  the  values  of  a  result  table  or  a  group  and  return  a 
single  value.  For  example,  to  find  the  number  of  employees  in  the  Staff  table, 
you  could  type: 

SDL.  SELECT  CCLNTC*) 

FROM  Staff; 

12 


NOTE 

The  asterisk  symbol  (*)  indicates  that  the  COUNTf)  function  operates 
on  the  entire  row,  not  on  any  single  column. 

Using  the  SUM()  function,  you  can  calculate  the  total  monthly  payroll  from 
the  Staff  table.  You  would  type: 

SDL.  SELECT  SLM(Satary) 

FROM  Staff-, 

63410 

Using  the  MAX(),  MIN(),  and  AVG()  functions  you  can,  for  example,  find  the 
highest,  lowest,  and  average  salaries  in  the  Staff  table.  You  would  type: 

SDL.  S8ECT  M< (Salary),  MIN(SaLary),  A VGCSalary. ) 

FROM  Staff; 

6237  3783  5284.17 

Remember  that  aggregate  functions  operate  on  the  values  of  columns  in  all 
rows  of  a  result  table  or  group.  You  cannot  mix  aggregate  functions  and  reg¬ 
ular  columns  in  the  SELECT  clause,  except  as  allowed  by  the  GROUP  BY 
clause  (see  Chapter  4). 

The  aggregate  functions  allow  you  to  specify  the  DISTINCT  keyword.  This 
keyword  causes  these  functions  to  recognize  only  unique  values  in  a  column. 
For  example,  to  total  the  number  of  cities  represented  in  the  Customer  table, 
you  could  type: 

90..  SBJECT  CCLNTCDISTlNCr  City) 

FROM  CLstcmer; 

15 
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Aggregate  Functions  Combined  with  a  WHERE  Clause 

You  can  also  use  aggregate  functions  in  a  SELECT  statement  that  has  a 
WHERE  clause.  The  system  will  select  rows  using  the  WHERE  clause  and 
then  apply  the  aggregate  function  to  the  result  table.  For  example,  to  find  the 
number  of  customers  from  the  Customer  table  who  live  in  the  state  of  New 
York,  you  would  type: 

9GL.  SELECT  OCLNTC*) 

FRJM  Customer 
!+£RE  State  =  "NT; 

5 

In  this  example,  the  SELECT  command  first  creates  a  result  table  containing 
rows  where  the  State  column  matches  the  value  "NY" .  The  COUNT()  func¬ 
tion  then  calculates  and  displays  the  number  of  rows  in  the  result  table. 
Figure  3-5  shows  how  aggregate  functions  use  column  values  from  selected 
rows. 


CUST NO 

COMPANY  \ 

0001 

0003 

0009 

0011 

0016 

0017 

0018 

0019 

Leonerd  Desion  Servio*  ) 

Ac*  Furniture  t 

Custom  Fimitir*  / 

The  Office  I 

Amor-icon  Buncos*  Supply  \ 

BUck'f  Ftmttur*  St  or*  1 

Interior  Systems  / 

The  Designer 

/  CITY 

[state  I 

[  Z* 

\  Ooeensid* 

92054 

(  VMM 

54401 

\  Yonkers 

10709 

-  \  Nev  York 

10013 

)  Los  Angeles 

90233 

/  Sen  Frencisco 

94119 

(  HflVMkM 

53201 

\  Nrv  York 

10713 

0033 

interior  Designs  J  / 

VhltePletts  1 

10605 

0034 

0035 

L«  Cienege  Furniture  /  \ 

Volley  Furniture  f 

Los  Angeles 
\  Encino 

90815 

91316 

0036 

Hr*  Mor irons  V 

J  CMoego 

60619 

0040 

0042 

0043 

0045 

0046 

Design  Center  Interiors  \  *  *  «  1 

CoAens  Furniture  j  j 

To  Design  Fimrture  /  / 

CUssio  Interiors  f  \ 

CcmmereUI  Interiors  LTD  \  ] 

|  Lm  Vegas 

Sen  Frenoiscc 
RooAester 

St.  Louis 
i  Venture 

89106 

94119 

14625 

63106 

93003 

—  Rovs  setirfykig 
condition  vtiere 
stet*  •  HY* 
(COUHTC*)  ■  5) 


Figure  3-5  Aggregate  functions  with  a  WHERE  clause 

SELECT  with  BETWEEN,  IN,  and  LIKE  Predicates 

The  SELECT  command  allows  you  to  specify  search  conditions  that  use  the 
predicates  BETWEEN,  IN,  and  LIKE  in  the  WHERE  clause.  BETWEEN,  IN, 
and  LIKE  are  called  predicates  because  evaluation  of  their  WHERE  clause  is 
based  (or  predicated)  on  the  result  of  these  operations. 

■  BETWEEN  tests  for  a  value  within  a  specified  range 

■  IN  tests  for  a  value  matching  an  item  in  a  list 

■  LIKE  compares  a  character  column  to  a  specified  string 
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The  BETWEEN  Predicate 


The  BETWEEN  predicate  tests  whether  a  column  value  is  between  two  speci¬ 
fied  values.  BETWEEN  simplifies  the  writing  of  a  search  condition  and 
makes  the  resulting  search  condition  easier  to  read  and  understand. 

Using  BETWEEN,  you  can  replace  a  condition  like: 

WHERE  salary  >  -  1500  AND  salary  <  -  2500; 
with: 

WHERE  salary  BETWEEN  1500  AND  2500; 

The  range  specified  with  BETWEEN  is  inclusive ,  that  is,  rows  with  column 
values  that  match  either  of  the  two  values  specified  in  the  range  will  appear 
in  the  result  table,  as  well  as  those  between  the  specified  range. 

You  can  use  the  BETWEEN  predicate  with  character,  date,  and  numeric  type 
columns.  For  character  columns,  the  range  values  should  be  entered  with 
upper-  and  lower-case  letters  to  match  the  case  of  entries  you  expect  in  the 
column.  You  also  can  use  dBASE  functions  to  convert  range  values  or  the 
data  returned  from  columns. 


The  IN  Predicate 


The  IN  predicate  tests  whether  a  column  value  matches  one  of  those  speci¬ 
fied  in  a  list  of  values.  Like  BETWEEN,  the  IN  predicate  simplifies  the  writ¬ 
ing  of  a  search  condition  and  makes  the  resulting  search  condition  easier  to 
read  and  understand. 

Using  IN,  you  can  replace  a  condition  like: 

WHERE  state  -  'AZ*  OR  state  -  ’MO*  OR  state  -  ’WI' 
with: 

WHERE  state  IN  (' AZT ,’ MO* ,' WI’ ) 

For  example: 


9GL.  SELECT  Carpary,  Address,  City,  State,  Zip 
mCM  Cistmer 

ld£RE  State  IN  CAT/MT/VT); 


otany 

ADORESS 

CITY 

STATE 

CZIP 

Ace  RmitLre 

I960  Lindley  Awe. 

fesau 

UI 

54401 

Interior  Systems 

859  Kenwood  St. 

ttiluaJcee 

WI 

53201 

Baker  Rmitire 

670D  Tyler  St. 

Phoenix 

AZ 

85012 

Modem  Ftmittre  Store 

366  Shirley  Awe. 

Phoenix 

AZ 

85004 

Al's  RmitLre  &  SLpplies 

40555  Brentwood 

St.  Louis 

M0 

63121 

Ccntenporary  Desigis 

5670  Colorado  Blvd. 

MiluaUcee 

WI 

Classic  Interiors 

2015  Edncntcn 

St.  Louis 

MO 

63106 
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You  can  use  the  IN  predicate  to  specify  lists  for  date  and  numeric  data  type 
searches,  besides  the  character  types  illustrated  in  the  example.  You  can 
include  dBASE  functions,  memory  variables,  other  column  names,  ajjd  the  ^ 

USER  keyword  in  place  of  values.  Also,  although  expressions  cannoTt  be  Y 

specified  in  a  value  list,  you  can  specify  a  single  expression  to  repla'ce  the 
value  list  (as  long  as  it  does  not  contain  an  SQL  aggregate  function). 

The  LIKE  Predicate 

The  LIKE  predicate  selects  rows  by  comparing  a  character  column’s  value 
with  a  specified  character  stringjhe  USER  keyword,  or  a  character-type 
memory  variable.  Besides  exact  Character  string  searches,  the  LIKE  predi¬ 
cate  allows  you  to  specify  wildcard  characters  in  the  search  string.  This 
means  that  column  values  matching  the  specified  pattern  will  also  appear  in 
the  result  table.  The  wildcard  characters  you  can  use  are: 

■  underscore  (_)  —  match  any  single  character 

■  percent  symbol  (%)  —  match  any  number  of  characters 

You  can  use  the  single-character  wildcard,  for  example,  to  display  cus¬ 
tomers  from  states  starting  with  the  letter  N: 


SQL.  SELECT  Corpora,  City's  States  Zip 
FROM  CLstaner 
HERE  State  LIKE  0NJ; 


COPAW 

CITY 

STATE 

Czip 

Custom  Fimitxre 

Ycrkers 

NT 

10709 

The  Office 

New  York 

NT 

10013 

The  Designer 

New  York 

NT 

10713 

Las  Vegas  Furniture 

Las  Vegas 

iw 

89106 

Accent  FunitLre  Designs 

Las  Vegas 

W 

891GB 

Interior  Designs 

White  Plains 

NT 

10605 

Design  Canter  Interiors 

Las  Vegas 

W 

89106 

To  Design  FunitLre 

Rochester 

NT 

14625 

You  can  use  the  multiple-character  wildcard  symbol,  for  example,  to  display 
parts  that  contain  the  text  string  "DESK*  as  part  of  their  description: 


9GL.  SELECT  DISTINCT  RrtJX>s  Descript 
FROM  Irverrtry 

U€FE  Descript  LIKE  "XX EXT; 

PART_N0  DESOTPT 

1007  WDCD  DESK-5IMLE  PEDESTAL 

1025  DE9C-EXECUTIVE-5  FOOT 

1027  DE3C-EXE(imVE-6  FOOT 
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Combining  BETWEEN,  LIKE,  and  IN  Predicates 

Just  as  with  simple  comparisons  in  the  WHERE  clause,  you  can  combine 
BETWEEN,  IN,  and  LIKE  predicates  with  the  AND,  OR,  and  NOT  logical 
operators.  You  can  also  enter  parentheses  to  clarify  or  change  the 
precedence  when  combined  comparisons  are  evaluated. 


Ordering  Displays 


In  previous  examples,  the  rows  of  the  result  tables  appeared  in  the  same 
order  in  which  you  added  to  the  SQL  tables.  To  change  the  order,  you  can 
use  the  ORDER  BY  clause  of  the  SELECT  statement.  The  syntax  of  the 
SELECT  statement  now  becomes: 


SELECT  <  columns> 

FROM  <  tables  > 

WHERE  <  condition  > 

ORDER  BY  <  column/integer >  [ASC/DESC] 
[,  <]column/integer >  [ASC/DESC]...]; 


J 


The  columns  you  use  in  the  ORDER  BY  clause  must  also  be  included  in  the 
SELECT  clause.  Also,  you  may  specify  integer  values  in  the  ORDER  BY 
clause  to  indicate  ordering  by  a  derived  column.  Integer  values  specified  in 
the  ORDER  BY  clause  correspond  to  column  positions  of  the  SELECT  state¬ 
ment’s  result  table. 


7b  speed  data  retrievals,  you  should  construct  indexes  that  match  the 
columns  on  which  you  often  order  your  data. 


Ordering  SELECT  Results  on  a  Single  Column 

With  the  ORDER  BY  clause,  you  specify  one  or  more  columns  on  which  to 
order  the  display.  Rows  are  arranged  in  ascending  or  descending  order 
based  on  the  values  in  specified  columns.  For  example,  to  display  the  part 
descriptions  in  the  Inventry  table  in  alphabetical  order,  you  could  type: 

9GL.  SRfCT  Rsrtjn,  Descript,  Location,  Ch_hard 
FROM  Inventry 
CRDBf  Bf  Descript  ASC; 

The  ASC  keyword  specifies  that  the  table  should  be  displayed  in  ascending 
order.  This  keyword  is  optional  since  ascending  order  is  the  default.  How¬ 
ever,  you  may  want  to  include  it  anyway  to  clearly  indicate  your  choice. 
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Ordering  SELECT  Results  on  More  than  One  Column 

Tb  order  the  display  using  more  than  one  column,  enter  each  column  fol¬ 
lowed  by  either  the  ASC  or  DESC  keyword  (ASC  optional).  Separate  each 
column  entry  with  a  comma.  For  example,  to  order  the  display  of  rows  in 
the  Inventry  table  by  location  and  then  by  description,  you  would  type: 


SGL.  SELECT  R»rt_no,  Descript >  Location,  OLband 
FROM  Jr\entry 

ORDER  Bf  Location  ASC,  Descript  ASC; 


PARTJC  DESCRIPT 

UXATICN 

CN_HAND 

1009  CHAIR-ADJLSTABLE  SWVB. 

CHICAGO 

124 

1031  CHAIR-EXECUTIVE  SWVEL/TILT 

CHICAGO 

44 

1013  CHAIR-MDDEJW  R€UWTIC 

CHICAGO 

115 

1033  CHAIR-TRADITICNAL  ARM 

CHICAGO 

20 

1027  DE9C-EXECUTIVE-6  FOOT 

CHICAGO 

20 

1005  EXECUTIVE  SUITE  060CLE 

CHICAGO 

1 

1031  (HAIR-EXECUTIVE  SWVEL/TILT 

LOS  ANGELES 

79 

1013  CHAIR-MODERN  R€LWVHC 

LOS  ANGELES 

35 

1025  DE3C-EXECUTIVE-5  FOOT 

LOS  ANGELES 

63 

1001  WORCSTATON-BJCTRCNIC  OFFICE 

LOS  ANGELES 

3 

1006  WORCSTATICN-STAM) 

LOS  ANGELES 

22 

1031  CHAIR-EXECUTIVE  SUI\£L/TILT 

l«W  VORC 

76 

1015  CREDBGA-QAK  SLIDING  DOOR 

NBf  TORC 

15 

1025  069C-B(ECUTIVE-5  FOOT 

NBiTORC 

47 

1027  DESK-EXECUTIVE-6  FOOT 

FCWTORC 

56 

1005  EXECUTIVE  SUITE  ENSBCLE 

taroiK 

0 

1029  FILE  CABIhET-2  DRANK 

f&YORC 

200 

1019  TAELE-SOARD  R0CM 

NEW  >ORC 

12 

1CE2  TABLE-WALNJT  0CCASICNAL 

Y0FK 

5 

1007  WOOD  DESK-SINGLE  PEDESTAL 

n»\orc 

29 

When  you  specify  more  than  one  column  to  order  by,  the  rows  are  arranged 
in  order  by  the  first  column  entry.  Then  those  with  the  same  value  are 
arranged  according  to  the  second  column  entry. 
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Using  the  ORDER  BY  clause,  you  can  also  specify  some  columns  to  appear 
in  ascending  order  and  others  to  appear  in  descending  order.  Still  using  the 
Inventry  table,  you  might  want  to  list  parts  on  hand  with  the  location  in 
alphabetical  order  and  the  number  of  parts  on  hand  in  decreasing  order. 
You  would  type: 


SQL.  SELECT  Fbrt_ro,  Descript,  Location,  CftJ)and 
FROM  In^mtry 

ORDER  Bf  Location  ASC,  QxJrand  DESC; 


PARTJC  DESCRIPT 

L0CATICN 

ouwc 

1024  LJVP-BRASS  TABLE 

CHICAGO 

140 

1009  CHAIR-ADJUSTABLE  SWVH. 

CHICAGO 

124 

1013  CHAIR-MODERN  R£UWIC 

CHICAGO 

115 

1058  LAfP-DRAFTING  SWING  AW 

CHICAGO 

89 

1051  CHAIR-EXECUTIVE  SWIVEL/TILT 

CHICAGO 

44 

1007  WOOD  DESK-5IN3LE  PEDESTAL 

CHICAGO 

35 

^058  LAfP-DRAFTING  SWING  AW 

LOS  ANGELES 

169* 

1029  FILE  CABIfET-2  DRAWER 

LOS  ANGELES 

145 

1051  (HAIR-EXECUTIVE  SWIVEL/TILT 

LOS  ANGELES 

79 

1002  FILE  CABIhET-4  DRAWER 

LOS  ANGELES 

71 

1025  DE9C-EXECUTIVE-5  FOOT 

LOS  ANGELES 

(S3 

^019  TABLE-BOARD  ROCM 

raw* 

1? 

1022  TABLE-WALNUT  0CCASICNAL 

NEW  TCRC 

5 

1021  MANAGERS  OFFICE  ENSEKLE 

ICWYORC 

3 

1006  EXECUTIVE  SUITE  BB0BLE 

NEW  ra* 

0 

i  r\  srr^  I*'**  S 


1  •  V\A  Sp<*C«- 


In  this  example,  inventoried  items  are  displayed  in  ascending  order  based  on 
the  Location  column.  Rows  for  items  with  the  same  location  column  value 
are  arranged  in  descending  order  based  on  values  of  the  On.hand  column. 


ORDER  BY  with  the  WHERE  Clause 

If  you  use  the  WHERE  clause,  the  only  rows  that  appear  will  be  those  that 
satisfy  its  conditions.  By  adding  the  ORDER  BY  clause,  you  can  choose  the 
rows  to  display  and  arrange  those  rows  in  a  specific  order  in  a  single 
SELECT  statement. 

For  example,  using  the  previous  query  on  the  Inventry  table,  you  could  type: 

SQL.  SRFCT  FbrtSD,  Descript,  location,  ChJerd 
FROM  Inuntry 
HERE  Location  =  'CHICM3T 
ORDER  Bf  FbrLno; 
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CZr^icoescRiPT 

1001  OCfiGTAnCN-aECTRMC  OFFICE 

L0CATICN 

CHICAGO 

CNJWD 

2 

1005  EXECUTIVE  SUITE  ENSEMBLE 

CHICAGO 

1 

1007  WOOD  DOC-SINGLE  PEDESTAL 

CHICAGO 

35 

1009  CHAIR-ADJUSTABLE  SWIVEL 

CHICAGO 

124 

1013  CHAIR-MXEJN  F^GJMATIC 

CHICAGO 

115 

1024  LA*P-BRASS  TABLE 

CHICAGO 

140 

1027  D65K-EXEQJTTW-6  FOOT 

CHICAGO 

2D 

1051  CmiR-EXECUnVE  swmynLT 

CHICAGO 

44 

1032  FILE  CABINET-4  DRAWER 

CHICAGO 

15 

1033  CHAIR-TRADITICNAL  ARM 

CHICAGO 

2D 

1058  LAMP-DRAFTING  SWING  ARM 

CHICAGO 

89 

Grouping  Records 

Two  additional  clauses  of  the  SELECT  statement,  GROUP  BY  and  HAVING, 
allow  you  to  arrange  rows  into  groups.  You  can  then  perform  operations  on 
those  groups,  usually  using  the  aggregate  functions.  The  GROUP  BY  and 
HAVING  clauses  change  the  scope  of  these  functions  from  all  the  rows  in  a 
table  to  all  the  rows  within  a  group. 


The  GROUP  BY  Clause 

The  GROUP  BY  clause  combines  rows  from  a  SELECT  statement’s  result 
table  into  groups  in  which  specified  columns  have  the  same  value.  Each 
group  is  reduced  to  a  single  row  in  the  result  table.  The  columns  in  the  row 
either  identify  the  group  or  are  the  result  of  an  SOL  aggregate  function  act¬ 
ing  on  the  group. 

There  is  one  restriction  on  using  the  GROUP  BY  clause.  Each  column  name 
listed  in  the  SELECT  clause  must  also  be  included  in  the  GROUP  BY  clause, 
except  for  column  names  used  in  aggregate  functions  in  the  SELECT  clause. 

For  example,  you  can  use  the  GROUP  BY  clause  with  the  Inventry  table  to 
count  the  number  of  parts  available  in  all  locations.  You  would  type: 


SDL.  SHHJ  Partin,  Descript,  SJKQtJwtD 
FROM  Irxentry 

GFCLP  Bf  PariLPO,  Descript; 


PARTJO  DESCRJFT  SLMCChJvrd) 

1001  UORCSTATICN-0JECTRCNIC  OFFICE  5 

1002  HXE  OFFICE  SUITE  2 

1005  EXECUTIVE  SUITE  ENS0ELE  1 


1029  FILE  CABDET-2  DRAtER  345 

1051  Q-IAIR-EXECLfTIVE  SWIVEL/TILT  199 

1032  FILE  CABD€T-4  DRAWER  86 

1053  CHAIR-TRADITICNAL  ARM  20 

1038  UWHJRAFTING  SUING  ARM  306 
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In  this  example,  the  rows  in  the  Inventry  table  are  all  grouped  by  the 
Part_no  and  Descript  columns  The  SUM()  function  then  adds  the  quantity 
of  each  item  (the  On_hand  column)  in  each  group.  This  process  is  shown  in 
Figure  3-6. 


Figure  3-6  Grouping  rows  and  the  aggregate  function 


You  could  also  use  this  method  to  count  the  number  of  salespeople  in  each 
office  location.  You  would  type: 

9GL.  SELECT  Location,  OOLNTC*) 

FROM  Staff 
GULP  Bf  Location; 

LOCATION  COLMC*) 

CHICAGO  3 

UOS  ANGELES  5 

YORC  4 

The  GROUP  BY  clause  can  also  be  used  in  a  SELECT  statement  that  has  an 
ORDER  clause.  This  is  useful  because  the  GROUP  BY  clause  does  not  auto¬ 
matically  put  the  result  table  in  order  by  the  columns  used  to  form  the 
groups. 

For  example,  to  produce  an  inventory  of  all  parts  alphabetically  grouped  by 
the  description  of  each  part,  you  could  type: 


9GL.  SELECT  fbrt/v,  Descript,  SLJMQOnJsrd) 
FROM  Inuentry 
GRIP  Bf  Descript,  Fhrtio 
ORDBt  Bf  Descript; 
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PARTJ©  DESCRIPT  CNJW© 

1009  CHAIRtADJUSTABLE  SWIVB.  124 

1CB1  (HAIR-EXECUTIVE  9WIVEL/TILT  199 

1013  (HAIR-KXEW  FFCLMATIC  130 

1051  CHAIR-OCQjriVE  SWIVEL/TILT  199 

10B3  CHAIR-TRADITICNAL  AW  2D 

1015  CRED0ZA-QAK  SLIDING  DOOR  15 

1(25  DESK-EXECUTIVE-5  FOOT  110 

1027  DESK-EXECUTIVE-6  FOOT  76 

1005  EXECUTIVE  SUITE  ENS0BLE  1 

1029  FILE  CA8IMfr-2  DRAWER  345 

1C52  FILE  CABIFET-4  DRAWER  65 

1002  HOME  OFFICE  SUITE  2 

1024  LAM^-BRASS  TABLE  196 

1038  LAWHDRAFTING  SWING  AW  305 

1021  MANAGERS  OFFICE  BIS0BLE  3 

1019  TABLE-BOARD  ROCM  12 

1022  TABLE-WALNUT  OCCASIONAL  5 

1007  WOOD  DE9C-SINSLE  PEDESTAL  126 

1001  WORGTATICN-aECTRCNIC  OFFICE  5 

1006  WORKSTATICN-STAN)  22 


The  HAVING  Clause 


You  can  select  the  groups  that  appear  in  the  result  using  the  HAVING  clause. 

This  is  similar  to  the  way  the  WHERE  clause  selects  rows.  The  HAVING 
clause  specifies  a  condition  that  each  group  must  satisfy  before  it  can  appear 
in  the  result  table. 

For  example,  to  produce  an  alphabetically  ordered  inventory  listing  of  all 

parts  costing  more  than  $500  thA  you  have  more  than  10  on  hand,  you  q  \ 

could  type:  ^ 


SGL.  SELECT  Descript,  FhrtLPO,  SLMCChJvrxD,  Lhitcast 
FROM  Inventry 
U-ERE  wi  toast  >  SOD 
GRCLPgf  Descript,  fortsn,  Lhitcast 
WINS  SLM  (ChJvrxD  >  ID 
ORDER  Bf  Descript; 


<0) 


DESCRIPT 

part_no 

(ILHAM) 

LMT00ST 

CREDftlZA-CtfK  SLIDING  DOOR 

1015 

15 

745.00 

DESC-EJCCUTIVE-5  TOOT 

1025 

110 

965.00 

DESK-EXECUTIVES  FOOT 

1027 

76 

1475.00 

TABLE-BOARD  ROCM 

1019 

12 

4250.00 

WOOD  DESK-SINGLE  PEDESTAL 

1007 

126 

736-21 

NOTE 

The  HAVING  clause  is  norm  ally  used  with  the  GROUP  BY  clause.  If 
you  do  not  specify  a  GROUP  BY  clause,  the  HAVING  clause  operates 
on  the  entire  result  table  as  if  it  were  a  single  group. 
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The  UNION  Clause 


SQL  provides  one  other  method  to  combine  queries,  the  UNION  statement. 

It  combines  the  result  tables  of  two  or  more  different  SELECT  statem ents 
and  removes  any  duplicate  rows.  If  rows  from  one  SELECT  are  duplicated  in 
another,  only  one  will  appear  in  the  final  result  table.  Figure  3-7  illustrates 
the  operation  of  the  UNION  clause. 


CUSTOMER  TABLE 


Figure  3-7  Combining  queries  with  the  UMON  clause 


The  result  tables  from  different  queries  being  joined  must  be  compatible. 
That  is,  the  queries  must  have  the  same  number  of  columns  and  the  data 
types  of  columns  in  each  table  must  match.  (The  column  names  in  each 
query  can  be  different.)  For  character  columns,  the  column  widths  must  be 
the  same.  For  numeric  columns,  the  columns  must  define  the  same  total 
number  of  digits,  be  the  same  type  of  number  (fixed  or  floating  point),  and 
have  the  same  number  of  decimal  point  digits. 

You  can  order  the  result  of  a  UNION  by  placing  an  ORDER  BY  clause  in  the 
last  SELECT  statement  of  the  UNION.  The  ORDER  BY  clause  must  use  inte¬ 
gers  (corresponding  to  column  positions)  to  identify  the  columns  by  which 
the  result  is  ordered. 
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To  select  all  the  cities  in  which  you  have  customers,  staff,  or  inventory,  you 
could  type: 


SSL.  SELECT  City 
FROM  CLstomer 
UNION 

SELECT  Location 
FROM  Staff 
LNICN 

SE-ECT  Location 
FROM  Infantry 
ORDER  Bf  1; 


CHICAGO 


LjOS  ANGELES 
Las  Ve^ks 
Los  Angeles 
Milwaukee 
MEW  WflC 
New  York 
OqfANSIOfc 
Phoenix 
Rochester 
San  Francisco 
St.  Louis 
Ventira 
Uasau 


0 


0) 


White  Plains  r>, 

Ycrkers  — 


SO¬ 

SO. 


Type  a  ccmrand  (or  ASSIST)  and  press  the  ENTER  key  (DY)_ 


In  this  example,  the  cities  in  rows  of  three  different  tables  are  combined.  In 
the  Staff  and  Inventry  tables,  he  city  is  stored  in  a  column  with  a  different 
name  than  that  in  the  Customer  table.  However,  the  type  and  width  of  the 
field  is  the  same,  so  the  values  can  be  combined. 
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Joins  and 
Subqueries 


You’ve  already  learned  how  to  use  the  SELECT  command  to  display  data 
from  a  single  table.  Often,  though,  the  information  you  need  will  be  in  sev¬ 
eral  different  tables.  Most  people  build  individual  tables  to  contain  specific 
types  of  information. 

The  sample  database  is  a  good  example.  The  Inventry  table  contains  informa¬ 
tion  about  available  stock  items.  The  Sales  table  contains  basic  information 
about  sales,  most  notably  the  order  number  and  the  entry  date.  Individual 
items  that  are  part  of  a  sale  are  entered  in  the  Items  table.  The  Customer  and 
Staff  tables  contain  information  regarding  customers  and  salespeople, 
respectively. 

In  this  chapter,  you’ll  learn  to  construct  queries  and  do  other  database  oper¬ 
ations  on  more  than  one  SQL  table.  You’ll  use  the  SQL  SELECT  command 
for  queries  that  combine  and  select  data  from  one  or  more  tables. 


What  This  Chapter  Covers 

The  topics  covered  in  this  chapter  are: 

■  Joins  —  querying  data  combined  from  more  than  one  table. 

■  Simple  subqueries  —  nesting  one  query  within  another.  Each  inner 
nested  SELECT  query  is  evaluated  and  its  result  used  as  part  of  an  outer 
SELECT  query. 

■  Correlated  subquery  —  forming  a  subquery  in  which  inner  nested 
SELECT  queries  are  evaluated  once  for  each  row  in  an  outer  SELECT 
query. 


Preparing  for  This  Chapter 

The  examples  in  this  chapter  also  use  the  sample  SQL  tables  provided  with 
dBASE  IV.  (Refer  to  Appendix  D  for  a  listing  of  the  tables.)  To  run  the  exam¬ 
ples  in  this  chapter,  start  SQL  in  the  interactive  mode.  Activate  the  SQL 
Samples  database  with  the  START  DATABASE  command.  Remember  that  the 
same  commands  used  in  the  examples  can  also  be  embedded  in  dBASE  IV 
SQL  programs. 
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Joins 


You  can  use  a  single-statement  SELECT  command  to  get  information  from 
multiple  tables.  This  operation  is  commonly  called  a  join.  Joins  are  one  of 
the  features  that  characterize  the  operation  of  a  relational  database. 

Joins  are  useful  because  you  can  specify  a  query  to  display  data  from  multi¬ 
ple  tables  without  having  to  specify  a  procedure  or  write  a  program  to  get 
the  data  you  want.  Also,  any  time  you  want  to  change  the  query,  you  can 
simply  change  the  SELECT  statement  instead  of  writing  a  custom  program. 
You  can  add  the  same  clauses  to  a  SELECT  statement  for  a  join  as  you  would 
for  a  single  table.  These  include  the  WHERE,  GROUP  BY,  HAVING,  and 
ORDER  BY  clauses. 

When  using  the  SELECT  command  to  do  a  join,  you  specify  the  columns 
from  each  table  you  want  to  appear  in  the  result.  You  need  to  prefix  columns 
with  the  name  of  the  table  to  which  they  belong  if  a  column  with  the  same 
name  exists  in  more  than  one  table.  For  example,  Sales.Order.no  would  be 
the  Order.no  column  from  the  Sales  table.  Use  the  asterisk  wildcard  (for 
example,  Sales.*)  to  display  all  columns  from  a  joined  table. 

You  also  may  specify  join  conditions  using  a  WHERE  clause  to  indicate  the 
rows  from  each  table  that  you  want  to  appear  in  the  result. 

For  example,  to  do  a  join  of  the  Sales  table  with  the  Staff  table,  you  could 
type: 

SQL.  SELECT  Order_po,  Sale-date,  Staff  .Staff _ro,  Lastrme 
FROM  Sales,  Staff 

U£RE  Sales.  Staff_no  -  Staff.  Staffjv,' 


STAFFJO  LASTNAfC 
8  McLester 

6  Thonas 

19  tolfes 


QRDERJO  SALEJA7E 
20002  09/21/87 
HUB  09/21/87 
20004  09/21/87 


2COZ5  09/25/87 

20004  09/25/87 

20005  09/25/87 
20005  09/25/87 


3  Vietari 

12  Charles 

3  Vidcni 

4  Court-ay 


The  result  table  from  this  SELECT  statement  contains  the  columns  for  order 
number  and  date  of  sale  from  the  Sales  table,  and  the  Staff,  no  and  Lastname 
columns  from  the  Staff  table.  The  join  condition  (WHERE  clause)  specifies 
that  rows  from  the  Sales  table  are  joined  with  those  rows  of  the  Staff  table 
where  the  values  ofStaff.no  are  the  same. 
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NOTH 

1.  When  the  equals  operator  is  specified  in  the  join  condition,  the  join 
is  called  an  equijoin.  If  one  of  the  two  columns  on  which  an  equi- 
join  is  formed  (in  the  example,  the  Staff,  no  column)  is  eliminated 
from  the  result  table,  the  join  is  called  a  natural  join. 


2.  The  names  of  the  columns  specified  in  the  WHERE  clause  (the  join 
condition)  do  not  have  to  match.  However,  they  must  be  of  compati¬ 
ble  data  types. 


To  show  the  columns  that  join  the  Sales  and  Staff  tables  to  form  the  result 
table,  you  can  display  the  value  of  the  column  Staff,  no  in  each  of  the  two 
tables  by  typing: 


SDL.  SELECT  Order_no,  Salejdate,  Sales.Staffjv,  Staff  .Staff _po,  Lastname 
FROM  Sales, >  Staff 

HERE  Sales.  Staff_po  =  Staff  .Staff _po; 


CRDERJO  SALE-DATE 

STAFFJO 

STAFFJO 

LASTNAME 

20002  09/21/87 

8 

8 

McLester 

20DQ5  09/21/87 

6 

6 

Thomas 

20004  09/21/87  19  19  Ftolfes 


20025  09/25/87 

20004  09/25/87 
20025  09/25/87 

20005  09/25/87 


3  3  Vidoni 

12  12  Charles 

3  3  Vidcni 

4  4  Ccudray 


This  example  shows  that  in  forming  a  join,  all  other  rows  in  which  the  join 
condition  is  not  met  are  excluded  from  the  result  table. 


How  dBASE  IV  SQL  Joins  Tables 

In  a  join,  the  tables  are  combined  and  then  conditions  are  applied  to  the 
rows  to  form  the  result  table.  Figure  4-1  shows  the  logical  steps  taken  to 
complete  the  SELECT  statement  in  the  example. 
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E. 


ORDER  NO 

SALE-DATE 

ST  AFT  NO 

STAFF- NO 

LAST*  AM  j 

20002 

20002 

20002 

20002 

9/21 /87 
9/21 /S7 
9/21 /87 
9/21 /97 

0008 

0008 

0008 

0008 

0001 

0003 

0004 

0006 

Zwnbini 

VWonl 

CoudraM 

Thom** 

|  20002 

9/21 /87 

0008 

|  0008 

ll  20002  1 

[9/21/87 

1  0008 . 1 

9/21  /87 
9/21 /87 
9/21 /87 
9/21 /87 


0008 

0006 

0006 

0006 


0020 

0001 

0003 

0004 


20026 

20026 

9/25/87 

9/25/87 

0004 

0004 

QQZfll 

0001 

0003 

ZwTtmi  1 

Vldont 

20026 

20026 

9/25/87 

9/25/87 

0004 

0004 

0019 

0020 

Rolf** 

h^yj 

Figure  4-1  Natural  join 


You  can  see  that  the  entire  combined  table  could  be  large.  dBASE  IV  SQL 
therefore  uses  statistical  information  stored  in  the  system  catalog  files  to 
build  the  most  efficiently  combined  join  table.  Then,  it  reduces  the  table  to 
include  only  the  rows  you  see  in  the  result  table.  A  built-in  query  optimizer 
decides  how  dBASE  IV  SQL  can  most  quickly  arrive  at  the  final  result  table. 


Selecting  Data  from  a  Join 

You  can  specify  additional  conditions  other  than  the  join  condition  in  the 
WHERE  clause.  For  example,  while  joining  the  Sales  and  Staff  tables,  you 
can  further  limit  the  result  table  to  include  only  orders  taken  by  the  salesper¬ 
son  whose  last  name  is  Charles. 
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SQL.  SELECT  Order_po,  Sale-tbte,  Staff  .Staff _po,  Lastname 
FROM  Sales,  Staff 

HERE  Sales.  Staff _po  =  Staff  .Staff _ro 
AN)  Lastname  =  'Charles' ; 


CflD€R_N0  SALOATE 

STAFFJO 

LASTNAflE 

20006  09/22/87 

12 

Charles 

20009  09/22/87 

12 

Charles 

20013  09/23/87 

12 

Charles 

20024  09/25/87 

12 

Charles 

■r  NOTE 

You  can  also  use  dBASE  functions  in  the  WHERE  clause.  For  exam¬ 
ple,  UPPERf)  can  be  used  to  match  character  strings  whether  they  are 
entered  in  upper  or  lower  case. 


Here’s  another  example  of  a  join.  This  one  combines  information  from  the 
Inventry  and  Items  database  tables.  The  result  table  contains  the  columns 
you  typically  might  print  on  an  order  invoice  form. 

9GL.  SELECT  DISTINCT  Items.Fhrtno,  Descript,  Oty,  Lh  it  cost,  (Qty  *  Lhitccst) 
FROM  Items,  Inventry 
HERE  Inventry. Fbrtuv  -  Itcas.Fhrtso 
AN)  Ctderjx)  -  '2U2T; 


PAflTJC  DESCRIPT  OTY  IKITCOST 

1013  CHAIR-fCDEW  PELMATIC  8  275.80 

1024  LAAP-BRASS  TABLE  6  23D.79 

1025  DESK-EXECUnVE-5  FOOT  8  985.00 


GfTYMMTGOST 

2206.40 

1384.74 

7880.00 


The  SELECT  statement  includes  ordered  items  and  quantity  from  the  Items 
table,  and  the  description  and  cost  of  an  ordered  part  number  from  the 
Inventry  table.  One  of  the  columns  included  in  the  result  table  is  a  calcu¬ 
lated  column:  Qty  *  Unitcost.  The  DISTINCT  keyword  eliminates  duplicate 
rows,  as  shown  in  Figure  4-2. 


Figure  4-2  The  DfiTNCT  keyword  used  in  a  join 
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Greater-Than  and  Less-Than  Join  Operators 

You  can  specify  other  operators  other  than  equals  to  form  a  join.  For  exam¬ 
ple,  you  can  specify  either  a  greater-than  join  (using  the  >  operator  in  the 
join  condition)  or  a  less-than  join  (using  the  <  operator).  For  example,  you 
could  join  the  Inventry  and  Items  tables  to  display  the  locations  of  part  num¬ 
bers  for  which  quantities  on  hand  are  sufficient  to  ship  the  parts  for  a  certain 
order. 


9GL.  SEiCT  Onderjio,  Items. RartSD,  Qty, 

Descript,  Cftjard,  Location 
FROM  I  tens,  Inventry 

HERE  Items.  fbrCro  =  Imentry.FbrtJTO  MD 
CtLhard  >  Qty  FtD  Items.Order_po  =  "2J2T; 


ORDERjO  PART JC 

QTY 

DESCRIPT 

CNJW© 

LQCATICN 

20021 

1013 

8 

CmiR-MXGN  FNEUMATIC 

115 

CHICAGO 

20021 

1013 

8 

CHAIR-M30EHN  PNEUMATIC 

35 

LOS  ANGELES 

2021 

1(25 

8 

DE9C-EXECLnTVE-5  ROOT 

65 

LOS  ANGELES 

2021 

1(25 

8 

DE9C-EXECLmVE-5  ROOT 

47 

KEWTORC 

2021 

1(24 

6 

LNP-BRASS  TABLE 

140 

CHICAGO 

2021 

1(24 

6 

LAW^BRASS  TABLE 

56 

h&TORC 

The  ORDER  BY  Clause 

As  in  a  single-table  query,  you  can  use  the  ORDER  BY  clause  to  assure  that 
the  rows  in  the  result  table  appear  in  a  specific  order.  You  can  arrange  col¬ 
umns  in  ascending  (ASC)  or  descending  (DESC)  order,  or  a  combination  of 
the  two.  For  example,  you  could  type: 


SQL.  SRFCT  Orderly,  Sale_&tc,  Lastrme 
FROM  Sales,  Staff 

U-ERE  Sales.  StafLno  -  Staff. Staff jpo 
ORDER  Bf  Saleable  DESC,  Lastrme; 


ORDERJO  SALEJIATE 

LASTW€ 

2024 

&I25/& 

Charles 

7TX V* 

09/25/87 

Gxdray 

7TT7? 

C9/25/& 

Coudray 

2021 

09/25/87 

McLester 

are 

09/25/87 

Vidni 

?rre 

09/25/87 

Vidni 

Term 

09/24/87 

fterin 

20019 

09/24/87 

ter  in 

20)18 

09/24/87 

Michaels 

20017 

09/24/87 

Thcnas 

20013 

09/23/87 

Charles 

20016 

09/23/87 

ffadiick 

sninR 

09/22/87 

Vidani 

•xrrv 

09/21/87 

McLester 

20004 

09/21/87 

Fblfes 

shttk 

09/21/87 

Thcnas 

Terr* 

09/21/87 

Zanbini 
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In  this  example,  rows  in  the  result  table  are  displayed  in  descending  order 
according  to  the  date  of  each  sale.  For  sales  on  the  same  date,  the  rows  are 
displayed  in  ascending  order  by  the  last  name  of  the  salesperson.  Note  that  if 
you  reversed  the  columns  specified  in  the  ORDER  BY  clause  ( ORDER  BY 
Lastaame,  Sa1e_date  DESC ),  the  rows  would  appear  in  alphabetical  order  by 
salesperson,  with  sales  appearing  from  the  most  current  to  the  earliest  date 
of  sale. 

The  GROUP  BY  and  HAVING  Clauses 

You  can  also  use  the  GROUP  BY  clause  in  a  join.  The  GROUP  BY  clause 
reduces  the  display  of  grouped  rows  to  a  single  row  in  the  result  table.  Rows 
are  grouped  together  when  all  the  grouping  column  values  for  one  row  are 
duplicated  in  the  corresponding  columns  of  another  row.  The  columns  spec¬ 
ified  in  the  SELECT  clause  are  either  grouping  columns  or  are  the  result  of 
an  SQL  aggregate  function.  Each  column  in  the  SELECT  clause  must  also  be 
specified  in  the  GROUP  clause,  unless  the  column  is  named  in  an  SQL  aggre¬ 
gate  function. 

For  example,  you  can  use  the  GROUP  BY  clause  to  group  the  sales  for  each 
salesperson. 

SQL.  SELECT  Staff .Staftro,  Lustrum,  COLNTC*) 

FROM  Staff,  Sales 

WERE  Staff. Staff _po  =  Sales.  Staffjv 
GROLP  Bf  Staff.  Staffjo,  Las  frame; 


STAFFJO  LASTNKC  GOLNT  (*) 

1  Zanfeini  2 

3  Vidoni  3 

4  Coudrey  2 

6  Thaws  2 

8  McLester  3 

11  Michaels  2 

12  Charles  4 

13  Mwin  2 

15  Roddick  4 

19  Rolfes  1 


The  COUNT  (*)  aggregate  function  operates  on  the  rows  for  each  group  (the 
sales  each  salesperson  made)  and  produces  a  count  that  is  displayed  next  to 
the  StaffLno  and  Lastname  column  values  for  each  salesperson. 

You  can  select  the  groups  that  appear  in  the  result  with  the  HAVING  clause. 
You  can  also  use  the  ORDER  BY  clause  to  arrange  the  rows  in  the  final 
result  table.  For  example,  you  can  display  the  salespeople  who  made  more 
than  two  sales  in  order  by  the  number  of  sales  each  one  made. 
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9GL.  SELECT  Staff. Staffjv,  Lasframe,  OCLNTC*) 
FROM  Staff,  Sales 

HERE  Staff  .Staff _po  -  Sales.  Staffjv 
GRIP  Bf  Staff.  Staffjv,  Las  tram 
hmUS  COLNTC*)  >2 
ORDER  Bf  3; 


STAFFJO  LAS1NHE  OOLNT  (*) 

3  Vidani  3 

8  McLester  3 

12  Charles  4 

15  Roddick  4 


Figure  4-3  shows  the  operation  of  the  GROUP  BY  and  HAVING  clauses  in  the 
example. 


Groups  wh*r» - 

C0UHT(«)>2 


Figure  4-3  GROUP  BY  and  HAVMG  clauses 

Joining  More  than  Two  Tables 

You  can  join  more  than  two  tables  in  a  SELECT  statement.  With  each  new 
file  you  join,  you’ll  want  to  specify  one  or  more  additional  join  conditions. 
The  WHERE  clause  specifies  the  conditions  determining  which  rows  are 
included  in  the  result  table.  For  example,  to  join  the  Staff,  Sales,  and  Cus¬ 
tomer  tables,  you  could  type: 

9GL.  SELECT  Staff.  Staffjv,  Staff  .Las  frame,  Ordecjv,  Coopery,  City 
FROM  Staff,  Sales,  CLstcmer 
HERE  Staff.  Staftno  =  Sales.  Staffjv 
AfiD  Sales.  Cusfjv  -  CLstcmer.  Custjv 
ORDER  Bf  Staff. Lastnme; 
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STAFFJO 

LASTN#€ 

CRDER_ND  CCMR*NT 

CITY 

12 

Charles 

20006  New  Horizons 

Chicago 

12 

Charles 

20009  Interior  Systems 

Milwaukee 

12 

Charles 

20D13  New  Horizcns 

Chicago 

St.  Ixuis 

12 

Charles 

20024  Classic  Interiors 

4 

Coui-ay 

20022  A1  Office  Supply  Store 

San  Francisoo 

4 

Coudray 

20026  Black's  Furniture  Store 

San  Francisco 

6 

Thorns 

20D17  Ccntenporary  Designs 

Kilv0Lk.ee 

3 

Vicbni 

20008  The  Office 

New  York 

3 

Vicbni 

20023  Design  Center  Interiors 

Las  Vegas 

3 

Vidcni 

20025  The  Designer 

New  York 

1 

Zanbini 

20005  American  BLsinesse  Supply 

Los  Angeles 

1 

Zanbini 

20D14  Leonard  Design  Services 

Oceanside 

The  result  table  joins  the  Staff  and  Sales  tables  on  a  common  staff  number. 
The  Sales  and  Customer  tables  are  joined  on  a  common  customer  number. 

In  addition,  the  result  table  is  ordered  by  the  last  names  of  salespeople  in  the 
Staff  table.  The  result  is  a  list  of  the  salesperson  and  the  corresponding  cus¬ 
tomer  (company)  for  each  order  in  the  Sales  table. 

Joining  a  Table  with  Itself 


Using  the  SQL  SELECT  command,  you  can  join  a  table  to  a  copy  of  itself. 

This  operation  is  called  a  self-join.  Self-joins  allow  you  to  correlate  informa¬ 
tion  between  different  rows  of  the  same  table  and  combine  this  information 
in  rows  of  a  result  table.  For  example,  you  can  use  a  self-join  to  print  a  list  of 
supervisors  and  the  employees  who  work  for  them. 

To  do  a  self-join,  you  define  different  names  or  aliases  for  the  same  table. 
dBASE  IV  SQL  then  operates  as  if  the  aliases  referred  to  different  tables. 
Aliases  allow  SQL  to  perform  different  queries  simultaneously  on  different 
parts  of  the  table. 

For  example,  using  the  Staff  table,  you  could  list  the  supervisor  for  each 
employee  by  typing: 

SDL.  SELECT  SLper.Lastname/SLpervisea?,  Eap.Lastreme 
FROM  Staff  Btp,  Staff  SLper 
U-ERE  SLper.  Staff _po  -  Grp.SLpervisor 
ORDER  Bf  SLper. Lastname  DESC; 


SLPER.  LASTNttE 

"Supervises: 

f  EMMASTNAft 

Zanbini 

Supervises 

Goudray 

Zanbini 

Supervises 

McLester 

Zanbini 

Supervises 

fterin 

Zanbini 

Supervises 

Rolfes 

Vidcni 

Supervises 

Thomas 

Vidcni 

Supervises 

Roddick 

Vidorri 

Supervises 

Long 

Charles 

Supervises 

Michaels 

Charles 

Supervises 

Sanders 
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In  this  example,  Emp  and  Super  are  aliases  for  the  Staff  table.  However,  they 
function  as  if  they  were  completely  different  tables.  Figure  4-4  shows  the 
result  table  formed  by  the  self-join  and  the  rows  that  satisfy  the  WHERE  join 
condition. 


sJT  C  V'v  V/  (AcVin 


Figure  44  A  self -join 


Subqueries 

Just  as  you  can  use  joins  to  combine  tables  in  a  query,  you  can  use  subque¬ 
ries  to  combine  one  query  with  another.  In  a  subquery,  a  SELECT  statement 
is  nested  within  the  WHERE  clause  (or  in  the  HA\ftNG  clause)  of  another 
SELECT  statement.  The  nested  SELECT  statement,  called  an  inner  SELECT 
query,  supplies  values  for  the  search  condition  of  the  SELECT  statement  con¬ 
taining  it.  The  SELECT  statement  containing  the  nested  query  is  called  an 
outer  SELECT  query.  The  outer  SELECT  builds  the  final  result  table  based  on 
the  values  the  nested  subquery  provides. 

The  construction  of  the  outer  SELECT  statement  depends  on  the  number  of 
values  that  the  SELECT  subquery  statement  returns.  There  are  two  cases  to 
consider: 

■  Subqueries  that  return  a  single  value 

■  Subqueries  that  return  multiple  values  (more  than  one  row,  with  values 
in  a  single  column) 
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There  are  two  basic  types  of  subqueries,  simple  and  correlated.  In  a  simple 
subquery,  the  inner  subquery  is  evaluated  first,  independently  of  the  outer 
query.  The  inner  SELECT  statement  is  evaluated  and  its  result  used  as  part  of 
an  outer  SELECT  query.  In  a  correlated  subquery,  the  values  returned  by  the 
inner  subquery  are  dependent  on  values  supplied  to  it  by  the  outer  query. 

The  inner  SELECT  statement  is  evaluated  once  for  each  row  in  an  outer 
SELECT  query. 

This  section  first  describes  various  simple  subqueries  and  then  describes  cor¬ 
related  subqueries. 


Subqueries  Returning  a  Single  \felue 


The  simplest  type  of  subquery,  a  nested  SELECT,  is  one  that  returns  a  single 
value.  You  can  use  the  result  of  the  SELECT  in  place  of  a  value  in  a  WHERE 
clause.  For  example,  you  could  enter: 

9GL.  SELECT  Order jpo.  Salute 
FROM  Sales 
UERE  CLstifO  = 

(SELECT  Qjstso 
FROM  Customer 

UERE  Corpery  =  ' American  Business  Sippiy) 

ORDER  Bf  SaiejjBte; 

GRDBUO  SALEJJATE 
20005  09/21/87 
2C019  09/24/87 


This  example  displays  the  orders  where  American  Business  Supply  is  the  cus¬ 
tomer.  The  inner  query  looks  through  the  Customer  table  to  find  the 
customer  number  for  that  company.  The  outer  query  uses  this  value  of  cus¬ 
tomer  number  in  the  search  condition  WHERE  Cust.no  —  . 

You  can  also  use  the  SQL  aggregate  functions  in  a  subquery  to  return  a  sin¬ 
gle  value  from  a  SELECT  statement,  as  shown  in  the  following  example. 

9GL.  SRFCT  Lastrwe,  Salary 
FROM  Staff 
HERE  Salary  > 

(SELECT  /US (Salary) 

FROM  Staff) 

ORDER  Bf  Lastrme; 


LASTNWE 

SfUW 

Charles 

9945 

Coudray 

6237 

Roddick 

5495 

Thorns 

5875 

Vidorvi 

5780 

Zabini 

6Q0D 

This  example  displays  the  last  names  of  people  with  salaries  larger  than  the 
average  salary  computed  from  the  Staff  table.  The  inner  query  returns  a  sin¬ 
gle  value  computed  by  the  SQL  AVG()  function. 
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You  can  also  specify  the  logical  operators  AND,  OR,  and  NOT  in  the  WHERE 
clause  to  specify  multiple  subquery  SELECT  statements.  For  example: 

SQL.  SELECT  Order_no,  Sale-date 
FROM  Sales 
UERE  CUsHro  = 

(SELECT  CUstuv 
FROM  Customer 


WERE  Ccnpary  =  "American  Business  Sippl/) 
OR  Staff  _ro  = 

(SELECT  Staff_no 
FRCM  Staff 

WERE  Lastname  =  "Zarrbini"); 


0RDER.ND  SALEJJATE 
2DD05  09/21/87 
20D14  09/25/87 
2DD19  09/24/87 


This  example  displays  the  orders  where  American  Business  Supply  is  the  cus¬ 
tomer  or  the  staff  person  is  Zambini. 


Subqueries  Returning  Multiple  Values 

For  subqueries  that  return  more  than  one  row,  you  need  to  use  a  WHERE 
clause  that  can  accept  more  than  one  value.  You  can  use  the  predicate  key¬ 
words  IN,  ANY,  and  ALL  to  create  such  a  query.  If  a  subquery  contains  IN, 
ANY,  or  ALL,  it  can  only  return  a  single  column. 

Using  the  IN  Predicate 

For  example,  you  can  follow  the  IN  predicate  with  subquery  values  in  place 
of  the  value  list  that  is  normally  specified.  This  is  shown  below. 


SQL.  SBJECT  Orderjpo,  CUstjv,  Salejbte 
FROM  sales 
U-ERE  Custno  IN 

(SELECT  Custm 
FROM  Customer 
HERE  Zip  LD£  ’9t); 

ORDERJO  QJSTJO  SALEJATE 


200a 

34 

09/21/87 

xm; 

16 

09/21/87 

20012 

27 

09/22/87 

20014 

1 

09/23/87 

20019 

16 

09/24/87 

20021 

46 

09/25/87 

■xrv? 

27 

09/25/87 

XTPA 

17 

09/25/87 
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The  subquery  SELECT  statement  returns  customer  numbers  from  rows  with 
zip  code  column  values  in  which  the  first  digit  is  9.  The  customer  number 
values  are  then  substituted  for  the  list  of  values  used  by  the  IN  predicate. 
The  WHERE  clause  in  the  outer  query  is  evaluated  as  true  if  a  column 
matches  any  of  the  values  returned  by  the  subquery.  Figure  4-5  illustrates 
the  operation  of  the  subquery. 


Si£qu*nj 

V«1UM 


Customer  TAW 


ourtom* r  tAW) 


0 


Figure  4-6  Subquery  returning  multiple  values 


NOTE 

Nested  SELECT  queries  cannot  contain  ORDER  BY  clauses  or  a 
UNION  clause.  Subqueries  may  contain  a  GROUP  BY  or  HAVING 
clause,  but  there  can  be  only  one  in  the  entire  query  statement,  count¬ 
ing  those  in  both  inner  and  outer  queries. 
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Using  the  ANY  Keyword 

You  can  use  the  ANY  keyword  to  determine  whether  the  WHERE  condition 
is  true  for  any  of  the  values  returned  from  a  subquery.  For  example,  you 
could  type: 


SQL.  SELECT  Staff _po,  Firstrame,  Las  frame,  Hi  redate,  Location,  Commsskn 
FROM  Staff 

kf£RE  Garni ssien  <  ANf 
(SELECT  Gamissian 
FROM  Staff 

U€RE  Location  =  ’CHICAGO; 


JO  FIRS1N#€  LASTNAAE 

HIRSUTE  LOCATICN 

GOmiSSKN 

1  Rick 

Zanbini 

02/15/80  LOS  ANGELES 

5.0 

3  Cheryl 

Vidori 

Q3/06/8D  NBJ  YORK 

5.0 

4  Sandy 

Coudray 

06/06/80  LOS  ANGELES 

5.0 

6  Pat 

Thoms 

01/08/81  N&i  YORK 

5.0 

8  Debbie 

McLester 

04/12/81  LOS  ANGELES 

5.0 

12  Ted 

Charles 

02/02/83  CHICAGO 

5.0 

19  Chuck 

Rolfes 

09/09/84  LOS  ANGELES 

6.0 

20  Kathy 

Sanders 

03/23/85  CHICAGO 

5.0 

This  example  displays  the  salespeople  from  any  location  who  get  a  lower 
commission  than  any  salespeople  in  Chicago. 

Using  the  ANY  keyword,  the  WHERE  condition  can  contain  any  of  the  com¬ 
parison  operators,  such  as  equals,  less-than,  and  greater-than.  If  you  use  the 
equality  operator  («  ),  the  WHERE  clause  operates  like  the  WHERE  ...  IN 
form  of  subquery. 


Using  the  ALL  Keyword 

You  can  use  the  ALL  keyword  to  determine  whether  the  WHERE  condition  is 
true  for  all  the  values  returned  from  a  subquery.  The  following  example  is 
similar  to  the  last  one.  However,  it  displays  only  those  salespeople  who 
receive  a  higher  com  mission  ban  anyone  at  the  Chicago  location. 


SGL.  SRFCT  Staff _po,  Firstrame,  Lastname,  Hirechte,  Location,  Garni  ssien 
Fiat  Staff 

l*£RE  Cbmissicn  >  ALL 
(SELECT  Gamissian 
FROM  Staff 

hfERE  Location  =  ’CHICAGO; 


STAFFJO  FIRS7N#€  LASTNAJC 
13  Jterk  Marin 
15*ry  Roddick 


HIRSUTE  LOCATICN  COWSSICN 
06/05/83  LOS  #G£LES  11.0 
02/13/84  t&JYCfK  8U 
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Multiple  Subqueries 


You  can  nest  subqueries  within  another  subquery.  For  example,  you  could 
type: 


SQL.  SELECT  Custno,  Ccnpany,  Firstnme,  Lastreme >  City 
ETCH  Customer 
UEFE  Custiro  IN 
(SELECT  Cust.no 
FROM  Sales 
U€PE  Order_no  IN 
(SELECT  Order_ro 
FROM  I  tens 


USE  Rtrtro  =  ’ICE?)); 


CUSTJO  CCM*MT 

FIRSTNflfC 

LASTNtfE 

CITY 

11  The  Office 

Dominiqje 

LeClerc 

New  York 

19  The  Designer 

Like 

tofabs 

New  York 

25  Kxiem  FumitLre  Store 

ffcbert 

htemilton 

Fhoenix 

40  Design  Center  Interiors 

Chuck 

Gilbert 

Las  Vegas 

46  Connercial  Interiors  LTD 

Sandy 

Yang 

Ventura 

This  example  displays  all  customers  who  have  ordered  a  specified  part.  The 
innermost  query  returns  order  numbers  that  contain  the  specified  part  num¬ 
ber.  The  next  outer  query  returns  the  customer  numbers  for  each  order  con¬ 
taining  the  specified  part.  Finally,  the  outermost  query  retrieves  company 
names  related  to  the  order  numbers. 


You  could  have  expressed  this  same  query  as  a  join  by  typing: 

■SGL^SBECT  CLstamer.  CLstno,  Company, 

Firstnme ,  Lastnme,  City 
FRDN  CLsturer,  Seles,  Items 
U€FE  Customer.  Cust.no  -  Seles.  CUstno 
AN)  Seles.  OrderjTo  =  Items.Ordecjv 
AN)  Items.Fhrtno  =  '1(2?; 


All  queries  with  subqueries  can  be  expressed  as  joins.  However,  the  expres¬ 
sion  of  a  subquery  is  often  easier  to  understand  than  the  equivalent  join. 
Thus,  you  might  prefer  to  use  subqueries  rather  than  joins  as  a  way  to  write 
queries. 


NOTE 

While  you  can  express  all  subqueries  as  an  equivalent  join,  not  all 
joins  can  be  expressed  as  subqueries. 
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The  EXISTS  Predicate 

The  EXISTS  predicate  creates  a  special  form  of  subquery  that  returns  a  true 
or  false  value  to  a  WHERE  clause,  depending  on  whether  the  subquery 
returns  any  values.  If  the  associated  subquery  returns  a  value,  the  EXISTS 
search  condition  is  true.  Otherwise,  the  EXISTS  search  condition  is  false. 
NOT  EXISTS  reverses  the  logic  of  the  search  condition.  If  you  specify  NOT 
EXISTS,  the  search  condition  will  be  false  if  the  associated  subquery  returns 
a  value. 

The  following  example  illustrates  the  use  of  the  EXISTS  predicate. 


SQL.  S3.ECT  CustSD,  Ccrrpeny,  City,  State 
FROM  CLstaner 
ht£RE  EXISTS 
(SELECT  * 

FROM  Sales 

MERE  CLstaner.  custLno  =  Sales.  CLstuxO; 


CUSTJO  CDfWf 

CITY 

STATE 

1  Leonard  Design  Services 

Oceanside 

CA 

11  The  Office 

New  York 

NT 

16  American  Business  Supply 

Los  Angeles 

CA 

17  Black's  FlmitLre  Store 

San  Francisco 

CA 

18  Interior  Systems 

Milwaukee 

UI 

19  The  Designer 

New  York 

W 

25  ffedem  Furniture  Store 

Phoenix 

AZ 

27  A1  Office  Supply  Store 

San  Francisco 

CA 

31  AL's  Furniture  &  Supplies 

St.  Louis 

MD 

32  Ccn temporary  Designs 

Milwaukee 

HI 

34  La  Cienega  Furniture 

Los  Angeles 

CA 

36  New  Horizcns 

Chicago 

IL 

40  Design  Center  Interiors 

Las  Vegas 

NV 

43  To  Design  Furniture 

Rochester 

W 

45  Classic  Interiors 

St.  Louis 

MD 

46  Ccrrmercial  Interiors  LTD 

Ventura 

CA 

In  this  example,  EXISTS  is  true  for  rows  in  the  Customer  table  where  the 
customer  numbers  are  also  entered  in  the  Sales  table.  Because  of  the 
WHERE  EXISTS  clause,  the  result  table  of  the  query  only  contains  those 
rows  where  Custower.Cust.no  -  SaJes.Cust.no. 

You  can  display  the  opposite  information,  displaying  those  customers  who  do 
nor  have  a  current  order,  by  substituting  WHERE  NOT  EXISTS  for  WHERE 
EXISTS. 

You  can  use  more  than  one  EXISTS  or  NOT  EXISTS  predicate  in  the  same 
SQL  statement,  for  example,  to  construct  a  subquery  in  which  an  EXISTS  or 
NOT  EXISTS  query  is  itself  nested  in  another  EXISTS  or  NOT  EXISTS 
query. 


NOTE 

The  EXISTS  predicate  is  the  only  one  in  which  SELECT*  is  allowed  in 
a  subquery. 
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Correlated  Subqueries 

The  most  powerful  form  of  the  subquery  is  the  correlated  subquery.  In  this 
kind  of  subquery,  an  outer  query  supplies  a  value  from  each  of  its  rows  to 
the  inner  query.  The  inner  query  is  evaluated  once  for  each  of  these  values. 

If  both  the  inner  and  outer  queries  access  the  same  table,  you  need  to  assign 
aliases  for  each  table  reference,  since  the  inner  and  outer  queries  need  to 
access  different  rows  within  the  same  table  at  the  same  time. 

The  example  below  shows  how  a  correlated  query  works.  The  query  displays 
employee  information  for  the  people  at  each  location  with  the  highest  salary. 


SGL.  SELECT  Outer. Firstname,  Outer. Lastname,  Outer. Location, 
Outer. Hi rechte.  Cuter.  Salary 
FROM  Staff  Outer 
U£RE  Salary  = 

(SELECT  MX  (Salary) 

FROM  Staff  Inner 

WERE  Imer. Location  =  Outer. Location) 

ORDER  Bf  Outer.  Lastname; 


FIRS7N#€ 

LASTNAft 

LOCATION 

HI  REDATE 

SALARY 

Ted 

Charles 

CHICAGO 

02/02/83 

35*5 

Sandy 

Goudray 

LOS  ANGELES 

05/06/80 

6237 

Pat 

Thcmas 

YCRC 

01/08/81 

5875 
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In  this  example,  the  outer  query  supplies  the  values  of  the  location  column 
for  each  row  in  the  Staff  table  to  the  inner  query,  one  at  a  time.  Using  these 
values,  the  inner  query  determines  the  largest  salary  within  the  group  of 
employee  salaries  at  that  location.  The  outer  query  then  compares  the  value 
of  the  salary  column  within  each  row  of  the  Staff  table  with  the  maximum 
salary  for  the  same  group.  If  the  salary  matches  the  maximum,  the  row  is 
selected  for  the  result  table.  Figure  4-6  shows  how  the  final  result  is 
obtained. 


m  (hUx(8*iTf)fw  tw 

I  LA8TNAME  LOCATION  SALA 


INNER  QUERIES 


vt*rt  Owt*r  Oj*ry  A  Salary  va 
i  M*x(S*l *ry)  v«kJM 
Irvwr  Quarto 


OUTER  QUERY 


Figure  4-6  A  correlated  subquery  example 
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Here’s  another  example.  To  display  all  orders  for  customers  who  have  more 
than  one  current  order,  you  could  type: 


SQL.  SELECT  SI.  CLat-TO,  S1.Ch±r_no 
FROM  Sales  Si 
HERE  SI.CLstLPO  IN 
(SELECT  S.Cust-PO 
FROM  Sales  S2 

HERE  Sl.Ordecjv  O  !!  S2.0ndenjv) 
ORDER  fff  Si.  CLstLJT),  SI. Order jno; 


CUSTJO 

CRDERJO 

11 

amra 

11 

2QD16 

16 

arms 

16 

20019 

19 

any 

19 

20015 

19 

annas 

27 

20012 

27 

amaa 

31 

20D1O 

31 

arrm 

36 

arrrx, 

36 

20013 

36 

20018 

40 

20011 

40 

amps 

The  outer  part  of  this  query  passes  customer  values  for  each  order  to  the 
inner  query,  through  the  reference  of  alias  table  SI.  The  inner  query  checks 
alias  table  S2  to  see  if  it  contains  any  other  orders  with  the  same  customer 
value. 
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Combining 
SQL  and  ' 
dBASE 


In  earlier  chapters,  you  learned  how  to  use  SQL  commands  to  define  SQL 
tables  and  views,  and  how  to  insert,  retrieve,  and  update  data.  In  this  chap¬ 
ter,  you’ll  see  how  to  use  dBASE  commands  in  the  interactive  SQL  mode. 

This  chapter  also  provid^a  bridge  to  using  SQL  and  dBASE  commands  to 
design  database  application  programs.  In  the  interactive  environment,  you 
can  design  your  SQL  database  and  then  test  the  operations  you  plan  to  incor¬ 
porate  in  your  application.  Almost  all  the  dBASE  and  SQL  commands  used 
in  the  interactive  environment  can  also  be  used  in  an  application.  dBASE  IV 
also  provides  other  tools  (a  text  editor,  a  debugger,  and  a  compiler)  that  you 
can  use  interactively  to  help  build  your  application. 


What  This  Chapter  Covers 

The  topics  covered  in  this  chapter  are: 

■  Using  dBASE  commands  and  functions  in  SQL  mode 

■  Saving  queries;  creating  reports  and  labels 

■  Accessing  dBASE  database  files 

■  Importing  and  exporting  data 

■  Securing  SQL  data 

■  Using  SQL  on  a  Local  Area  Network  (LAN) 


r-s 


a 


Preparing  for  This  Chapter 

In  this  chapter,  you’ll  continue  to  execute  commands  in  the  interactive  SQL 
mode.  Before  starting  this  chapter,  make  sure  that  the  SQL  prompt  appears 
on  your  screen,  and  that  you’ve  activated  the  SQL  Sample  database  using  the 
START  DATABASE  command. 
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Using  dBASE  Commands  and  Functions  in  SQL  Mode 

The  SQL  language  itself  consists  of  a  small  set  of  commands  and  functions 
limited  exclusively  to  the  definition  and  access  of  data  in  tables.  Using  only 
SQL  commands,  you  can  define  or  delete  a  table  and  its  indexes,  and  insert, 
update,  delete,  or  query  (access)  data.  In  addition,  you  can  set  privileges  that 
restrict  access  to  the  data.  With  the  set  of  functions  SQL  provides,  you  can 
do  simple  statistical  operations  (SUM(),  COUNT(),  AVG(),  MINQ,  and 
MAXQ). 

dBASE  IV  includes  a  full  set  of  dBASE  commands  and  functions  that  you 
can  use  with  SQL.  In  interactive  mode,  for  example,  you  can  use  dBASE 
commands  to  create  and  print  reports  from  data  selected  by  SQL  queries. 
Other  commands  and  functions  allow  you  to  convert  or  format  data  in  SQL 
queries,  set  options,  and  develop  programs. 

dBASE  IV  has  separate  SQL  and  dBASE  modes  because  of  differences  in  the 
way  the  two  systems  access  data  (set  versus  record-pointer  orientation).  You 
can,  however,  effectively  use  both  dBASE  and  SQL  commands  to  operate  on 
the  same  data,  using  SQL  commands  to  retrieve  data,  and  dBASE  commands 
to  process  and  format  it. 

The  complete  sets  of  dBASE  commands  and  functions  you  can  use  in  the 
SQL  mode  are  listed  in  Table  5-1  and  Table  5-2,  respectively. 


NOTE 

Refer  to  Appendix  C  for  a  brief  description  of  all  dBASE  commands 
and  functions. 
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Table  5-1  dBASE  commands  allowed  in  SQL  mode 


?  ??  or  ??? 

&&  ’ 

@... CLEAR... 

@... DOUBLE/  PANEL/ NONE... 
@...FILLTO... 

@... SAY. .GET 
ACCEPT 

ACTIVATE  MENU 
ACTIVATE  POPUP 
ACTIVATE  SCREEN 
ACTIVATE  WINDOW 
BEGIN.. .END  TRANSACTION 
CALL 
CANCEL 
CASE  ** 

CLEAR  GETS 
CLEAR  MENUS 
CLEAR  POP  UPS 
CLEAR  TYPEAHEAD 
CLEAR  WINDOWS 
CLOSE  ALTERNATE 
CLOSE  FORMAT 
CLOSE  PROCEDURE 
COMPILE 
COPY  FILE 
DEACTIVATE  MENU 
DEACTIVATE  POPUP 
DEACTIVATE  WINDOW 
DEBUG 
DECLARE 
DEFINE  BAR 
DEFINE  BOX 
DEFINE  MENU 
DEFINE  PAD 
DEFINE  POPUP 
DEFINE  WINDOW 
DELETE  FILE 
DIRECTORY 
DISPLAY  FILES 
DISPLAY  HISTORY 
DISPLAY  MEMORY 
DISPLAY  STATUS 
DISPLAY  USERS 
DO 

DO  CASE.. .CASE... 

OTHERWISE.. .ENDCASE 
DO  WHILE 
EJECT 


ERASE 

EXIT 

HELP  IF...ELSE...ENDIF 

INPUT 

LIST  FILES 

LIST  HISTORY 

LIST  MEMORY 

LIST  STATUS 

LIST  USERS 

LOAD 

LOGOUT 

LOOP 

MODIFY  COMMAND/ FILE 
MOVE  GETS 
MOVE  WINDOW 
NOTE 

ON  ERROR/ ESCAPE/ KEY 
ON  PAD 
ON  PAGE 
ON  READERROR 
ON  SELECTION  PAD 
ON  SELECTION  POPUP 
PARAMETERS 
PLAY  MACRO 

PRINTJOB...ENDPRINTJOB 

PRIVATE 

PROCEDURE 

PROTECT 

PUBLIC 

QUIT 

READ  [SAVE] 

RELEASE 
RELEASE  MENUS 
RELEASE  MODULE 
RELEASE  POPUPS 
RELEASE  WINDOWS 
RENAME 

RESTORE  FROM  ADDITIVE 

RESTORE  MACROS 

RESTORE  MENU 

RESTORE  WINDOW 

RESUME 

RETRY 

RETURN 

ROLLBACK 

RUN 

SAVE  MACROS 
SAVE  TO 
SAVE  WINDOW 
SET 


[continued) 
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Table  5-1  dBASE  commands  allowed  in  SQL  mode  ( continued) 


SET  ALTERNATE  ON/ OFF 

SET  ALTERNATE  TO 

SET  AUTOSAVE  ON/ OFF 

SET  BELL 

SET  BELL  ON/ OFF 

SET  BORDER 

SET  CENTURY  ON/ OFF 

SET  CLOCK  ON/ OFF 

SET  CLOCK  TO 

SET  COLOR  OF 

SET  COLOR  ON/ OFF 

SET  COLOR  TO 

SET  CONFIRM  ON/OFF 

SET  CONSOLE  ON/OFF 

SET  CONVERSION  ON/ OFF 

SET  CURRENCY  LEFT/ RIGHT 

SET  CURRENCY  TO 

SET  DATE 

SET  DEBUG  ON/ OFF 

SET  DECIMALS  TO 

SET  DEFAULT  TO 

SET  DELETED  ON/ OFF 

SET  DELIMITERS  ON/ OFF 

SET  DELIMITERS  TO 

SET  DEVELOPMENT  ON/ OFF 

SET  DEVICE  TO 

SET  DISPLAY  TO 

SET  DOHISTORY  ON/ OFF 

SET  ECHO  ON/ OFF 

SET  ENCRYPTION  ON/ OFF 

SET  ESCAPE  ON/ OFF 

SET  EXACT  ON/ OFF 

SET  EXCLUSIVE  ON/ OFF 

SET  FIXED  ON/ OFF 

SET  FORMAT  TO 

SET  FUNCTION 

SET  HEADING  ON/ OFF 


SET  HELP  ON/ OFF 

SET  HISTORY  ON/OFF 

SET  HISTORY  TO 

SET  HOURS  TO 

SET  INTENSITY  ON/ OFF 

SET  LOCK  ON/ OFF 

SET  MARGIN  TO 

SET  MARK  TO 

SET  MENUS  ON/ OFF 

SET  MESSAGE  TO 

SET  ODOMETER  TO 

SET  PATH  TO 

SET  PAUSE  ON/ OFF 

SET  POINT  TO 

SET  PRECISION  TO 

SET  PRINTER  ON/OFF 

SET  PRINTER  TO 

SET  PROCEDURE  TO 

SET  REFRESH  TO 

SET  REPROCESS  TO 

SET  SAFETY  ON/OFF 

SET  SCOREBOARD  ON/OFF 

SET  SEPARATOR  TO 

SET  SPACE  ON/OFF 

SET  SQL  ON/OFF 

SET  STATUS  ON/ OFF 

SET  STEP  ON/ OFF 

SET  TALK  ON/ OFF 

SET  TRAP  ON/OFF 

SET  TYPE  AHEAD  TO 

SHOW  MENU 

SHOW  POPUP 

STORE 

SUSPEND 

TEXT...ENDTEXT 

TYPE 

WAIT 


NOTE 

dBASE  commands  and  functions  that  open  a  database  file  (USE), 
position  a  database  file  record  pointer  (RECNO(),  GOTO,  and  SKIP) 
and  seek  or  display  data  (FIND,  SEEK,  and  DISPLAY)  are  not  in  the 
list  of  commands  allowed  in  SOL  mode.  SQL  commands  are  set- 
oriented  and  handle  the  operations  to  open  tables  and  find  data  in 
them  automatically. 
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Tabe  5-2  dBASE  functions  allowed  in  SQL  mode 


&* 

ABS() 

ACOS() 

A SC() 

ASIN() 

AT() 

ATANC) 

ATN2Q 

BAR() 

CALL() 

CDOW() 

CEILING() 

CHR() 

CMONTH() 

COL()* 

COMPLETED() 

COS() 

CTOD() 

DATE() 

DAY() 

DIFFERENCE() 
DISKS  PACEO* 
DMY() 

DOW() 

DTOC() 

DTOR() 

DTOS() 

ERROR()* 

EXP() 

HLE() 

FIXED() 

FKLABELO* 

FKMAX()‘ 

FLOAT() 


FLOOR( ) 
GETENV()* 

UFO* 

INKEYO* 

INT() 

ISALPHAO* 

ISCOLORO* 

ISLOWERO* 

ISUPPERO* 

I  STKEYO* 
L-FT() 

leno 

LIKE()‘ 

LINEN  0() 

LOG() 

LOG10() 

LOWER() 

LTRIM() 

MAX()* 

MDY() 

MEMORYO* 

MENU()‘ 

MESSAGE()* 

MIN()‘ 

MOD() 

MONTH() 

NETWORKO* 

OS()* 

PAD() 

PCOL() 

PI() 

popupo 

PRINTSTATUSO* 


PROGRAMO* 

PROMPT()* 

PROW()‘ 

RAND() 

READKEYO* 

READVARO* 

REPLICATE() 

RIGHT( ) 

ROLLBACKO* 

ROUND() 

ROW()* 

RTOD() 

RTRIM() 

SET(  )* 

SIGN() 

SIN() 

SOUNDEXO 

SPACE() 

SQRT() 

STR() 

STUFFO 

SUBSTR() 

SUM() 

TAN() 

TIME() 

TRANSFORM() 

TRIM() 

TYPE()‘ 

UPPER() 

USER() 

VALO 

VERSION() 

YEAR() 


NOTE 

dBASE  functions  that  are  allowed  in  SOL  mode  but  not  in  an  SOL 
statement  are  noted  with  an  asterisk  placed  next  to  the  function. 
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Entering  dBASE  Commands 

When  you  use  one  of  the  dBASE  commands  listed  in  Table  5-1  at  the  SQL 
dot  prompt,  enter  the  entire  command  on  one  line  without a  semicolon  fol¬ 
lowing  the  command.  Then  press  ♦♦  to  execute  the  command.  For  example, 
say  you  wanted  to  change  the  way  dates  appear  when  you  enter  an  SQL 
SELECT  statement.  To  display  dates  in  the  French  date  format,  you  would 
type: 

SGL.  SET  DATE  70  FRENCH 

The  next  time  you  displayed  date  information  from  a  table,  it  would  appear 
in  the  new  format. 

If  you  want,  you  can  specify  additional  SET  options.  For  example,  you  could 
route  to  the  printer  SQL  statements  and  the  results  they  produce  by  typing: 

SGL.  SET  PRINTER  CN 

Now  everything  you  type  will  echo  to  the  printer  after  you  press  — •»  to  exe¬ 
cute  a  command.  To  stop  echoing  to  the  printer,  you  would  SET  PRINTER 
OFF. 

You  can  capture  the  SQL  commands  you  type  and  their  results  in  a  text  file 
by  using  the  SET  ALTERNATE  TO  and  SET  ALTERNATE  ON  commands. 

SGL.  SET  ALTERNATE  TO  Sessien 
SGL.  SET  ALTERNATE  CN 

The  SET  ALTERNATE  TO  command  in  this  example  opens  a  text  file  named 
Session.txt,  and  the  SET  ALTERNATE  ON  command  starts  recording 
keyboard  entries  and  screen  displays.  You  can  stop  recording  in  the  file 
by  entering  SET  ALTERNATE  OFF  and  then  close  the  file  with  CLOSE 
ALTERNATE.  You  can  then  use  the  TYPE  command  to  display  the  contents 
of  the  Session.txt  file,  or  use  the  command  MODIFY  COMMAND  to  edit  it. 


Using  dBASE  Functions 

dBASE  functions  listed  in  Thble  5-2  can  be  used  with  SQL  statements  (as 
you’ve  seen  in  the  examples  in  previous  chapters).  You  can  use  dBASE  func¬ 
tions  in  the  SELECT  clause  to  transform  or  combine  column  data  before  it 
appears  in  a  result,  or  within  a  WHERE  clause  to  evaluate  conditions. 

Some  examples  in  Chapter  3  used  functions  to  define  condition  expressions 
in  the  WHERE  clause.  Here  is  an  additional  example  that  shows  functions 
used  in  both  the  SELECT  and  WHERE  clause. 

SGL.  SELECT  RTRIN(Firstname)  +  SPACE (1)  +  Lastnm 
FROM  Staff 

UERE  LPPERCLastname)  LIKE  "CX; 
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This  statement  removes  trailing  blanks  following  the  first  name  and  then 
concatenates  the  first  names  and  last  names  of  staff  members  whose  last 
names  start  with  C.  The  SPACE()  function  adds  a  single  space  between  each 
first  and  last  name  displayed. 

The  SAVE  TO  TEMP  Clause 


dBASE  IV  provides  a  SAVE  TO  TEMP  clause  with  the  SQL  SELECT 
com  mand  to  allow  you  to  save  the  result  of  SQL  queries.  The  SAVE  TO 
TEMP  clause  follows  the  last  clause  of  a  SELECT  query.  The  syntax  is: 

SAVE  TO  TEMP  <  table  name>  [(column  list)]  [KEEP]; 

The  SAVE  TO  TEMP  clause  is  useful  in  two  ways.  First,  it  lets  you  break  up 
complex  SELECT  statements  into  smaller,  more  manageable  operations.  By 
dividing  an  operation  such  as  a  complicated  join  or  subquery,  you  can  do 
part  of  the  query  and  check  the  intermediate  table  to  see  if  you’re  getting  the 
correct  results.  Then,  when  you  do  the  rest  of  the  query  on  a  smaller  table, 
you  can^more  confident  that  the  final  result  will  be  the  one  you  want. 

The  second  use  of  the  SAVE  TO  TEMP  clause  is  to  capture  the  results  from 
an  SQL  query  to  a  dBASE  database  file.  You  can  then  use  the  database  file  to 
produce  reports  and  labels  with  dBASE  IV’s  report  and  label  design  screens, 
or  process  data  in  the  file  with  other  dBASE  IV  commands.  To  save  the  tem¬ 
porary  table  to  a  dBASE  database  file,  you  need  to  specify  the  KEEP  clause. 

Unless  you  save  them,  tables  created  with  the  SAVE  TO  TEMP  clause  are 
temporary  and  are  only  available  during  the  current  SQL  session  using  the 
same  database.  Their  definition  is  only  added  temporarily  to  catalog  tables 
for  the  current  database  (available  for  the  duration  of  the  current  SQL 
session).  To  save  a  query  to  use  in  later  sessions,  you  can  create  a  view  with 
the  CREATE  VIEW  command,  and  use  the  SELECT  statement  to  define  rows 
and  columns  in  the  view.  Or,  if  you’ve  specified  the  KEEP  option  to  create  a 
dBASE  database  file,  you  can  use  DB DEFINE  to  define  an  SQL  table  using 
the  database  file. 


be 

A 


The  example  below  shows  how  you  can  use  the  SAVE  TO  TEMP  clause. 
Expanding  on  an  example  from  Chapter  4,  you  could  create  a  single  query 
statement  that  generates  the  detail  for  orders  you  want  to  appear  on  invoice 
forms.  You  generate  the  necessary  information  by  joining  the  Customer, 
Sales,  Items,  and  Inventry  tables.  You  can  save  the  final  result  table  and  use 
it  to  print  a  report.  Because  the  invoice  requires  joining  four  different  tables, 
you  might  want  to  break  the  join  into  two  more  manageable  and  easily 
understood  query  statements. 
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Your  first  step  would  be  to  join  information  from  two  tables,  Items  and 
Inventry,  to  generate  the  detail  lines  for  each  ordered  item.  For  example, 
you  would  type: 

SDL.  SELECT  Order_po,  Items.PartJX>,  Descript, 

Qty,  Lhitccst,  (Qty  *  lhitccst) 

FROM  Items,  Imentry 

UFERE  Invent ry.  fbrt_po  -  Items. FbrtLPO 

ORDER  Bf  Items. Crder_no 

SAVE  TO  WE3  Detail  (Order jx>,  Fbrtro,  Descript, 

Qty,  Lhitccst,  Total); 

This  SELECT  statement  returns  a  table  with  all  the  detail  lines  needed  to 
generate  invoices  for  all  order  numbers.  The  SiAVE  TO  TEMP  clause  saves 
the  result  table  as  a  temporary  SQL  table  named  Detail.  All  the  columns  have 
the  same  names  as  in  the  original  table  except  the  calculated  column,  which 
is  renamed  Total.  The  ORDER  BY  clause  arranges  the  table  according  to 
order  number,  which  helps  you  see  if  the  query  you’ve  constructed  is  correct 
so  far.  To  check,  you  could  type: 

SQL.  SELECT  * 

FROM  Detail; 


NOTE 

Saving  information  to  a  database  file  (with  the  KEEP  option)  from  a 
numeric  type  calculated  column  or  expression  will  create  a  Held  in 
the  database  file  of  the  same  data  type.  Its  size  will  be  fixed  at  20  dig¬ 
its  with  up  to  two  decimal  places  depending  on  whether  the  column  or 
expression  is  an  integer,  numeric,  decimal,  or  float. 


Next,  you  can  finish  building  the  table  needed  to  generate  invoices  by  joining 
the  Detail  table  with  the  Sales  and  Customer  tables. 

SQL.  SELECT  Lastname,  Sale-date,  Detail. Order jpo,  Fbrt/o,  Descript, 

Qty,  Detail.Lhitcost,  T^tal 
FROM  Customer,  Sales,  Detail 
UERE  Customer. Order_no  =  Detail. Orderjx) 

AN)  Customer. Order_po  =  Sales.Order_po 
ORDER  Bf  Sales. Crderjo 

SAVE  TO  TBP  Invoice  (Lastname,  Date,  Order_po,  Part-no, 

Descript,  Qty,  Lhitccst,  Total)  KEEP; 

This  query  finishes  the  join  operation  needed  to  collect  all  the  information  to 
generate  invoices.  It  then  saves  the  result  table  as  a  database  file  named 
Invoice  (because  of  the  KEEP  keyword).  You  can  again  check  the  table  by 
typing: 

SQL.  SELECT  * 

FROM  Invoice; 
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The  only  step  remaining  is  to  create  and  print  the  invoice.  You  -an  use 
dBASE  IV’s  report  generator,  but  first  you  need  to  switch  bar*  to  the  dBASE 
dot  prompt  to  open  (USE)  the  database  file  you’ve  created  Vou  also  must 
specify  the  layout  of  the  report,  adding  sales  tax,  an  invoJce  price  total,  and 
whatever  other  detail  you  want.  When  you  use  the  report  generator,  you  ref¬ 
erence  the  columns  as  fields  to  be  included  in  the  report.  You  can  group  the 
report  by  order  number  to  print  each  invoice  on  a  separate  page.  (Refer  to 
Chapter  9  of  Using  the  Menu  System  for  details  on  how  to  create  and  print 
reports.) 

From  the  last  example,  you  can  see  how  to  use  SQL  commands  to  retrieve 
data,  and  dBASE  commands  to  form-*  and  process  it.  The  effectiveness  of 
this  approach  is  more  evident  when  you  use  SQL  and  dBASE  together  in  an 
application  program,  as  you’ll  see  t  ’  the  next  chapter. 


Accessing  dBASE  Database  Files 

Tables  and  indexes  created  by  SQL  commands  have  the  same  internal  struc¬ 
ture  as  dBASE  database  (.dbf)  and  index  (.mdx)  files  respectively.  However, 
when  you  create  tables  and  indexes  using  SQL  commands,  additional  infor¬ 
mation  about  the  tables  and  indexes  is  stored  in  SQL  catalogs.  SQL  uses  the 
catalog  information  to  access  data  from  SQL  tables.  Thus,  to  use  SQL  com¬ 
mands  with  a  dBASE  database  file  created  outside  of  SQL  mode,  you  need  to 
update  SQL  catalog  tables  with  the  DBDEFINE  command  to  include  infor¬ 
mation  about  the  database  file  and  any  associated  indexes  you  want  to  use 
with  it.  Once  a  database  file  has  been  defined  as  an  SQL  table,  you  cannot 
modify  its  structure  using  dBASE  commands. 

Conversely,  in  dBASE  mode,  you  can  use  dBASE  commands  to  access  most 
SQL  tables  without  doing  any  advance  conversion  or  preparation,  since  SQL 
tables  are  already  stored  as  a  database  file.  You  can  add,  update,  or  delete 
data  in  the  database  file  using  dBASE  commands,  unless  you’ve  installed 
PROTECT.  In  that  case,  database  files  are  encrypted  and  may  be  accessed 
either  in  dBASE  mode  or  SQL  mode,  but  not  both. 


The  DBDEFINE  Utility  Command 

The  DBDEFINE  command  creates  catalog  entries  for  tables  (database  files) 
and  their  associated  indexes.  The  catalog  information  allows  you  to  access 
these  tables  with  SQL  commands.  The  syntax  for  the  DBDEFINE  command 
is: 

DBDEFINE  [  <  .dbf  filQiame  >  ]; 

DBDEFINE  updates  the  catalog  tables  of  the  active  database  for  a  single  data¬ 
base  file  or  for  all  database  files  in  the  current  database  directory. 

To  move  all  the  database  files  for  a  dBASE  application  into  a  new  SQL  data¬ 
base,  you  need  to  do  the  following: 

1.  Create  an  SQL  database  for  the  application  using  the  CREATE  DATABASE 
command.  (If  you  want  to  add  the  database  files  to  an  existing  SQL  data¬ 
base,  you  can  skip  this  step.) 
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2.  Copy  the  database,  memo,  and  index  files  into  the  database  directory  to 
which  you  want  the  files  transferred.  (You  can  use  the  dBASE  COPY 
FILE  command  in  SQL  mode.) 

3.  Activate  the  database  using  the  START  DATABASE  command. 

4.  Run  the  DBDEFINE  comm  and. 

All  the  database  files  copied  into  the  database  directory  will  be  entered 
in  the  database  catalog  tables.  (To  create  catalog  entries  only  for  particu¬ 
lar  database  files  in  the  database,  specify  the  individual  database  file¬ 
names  with  the  DBDEFINE  command.) 


NOTE 

1.  You  cannot  update  an  SOL  catalog  to  include  definitions  of  dBASE 
views.  However,  you  can  create  an  SOL  definition  of  the  database 
files  represented  in  a  view,  and  then  create  an  SOL  view  equiva¬ 
lent  to  the  query  that  created  the  dBASE  view  file. 


2.  You  cannot  update  an  SOL  catalog  for  .ndx  index  files.  You  need 
to  convert  any  ndx  files  you  want  to  use  in  SOL  mode  to  mdx  tags 
and  then  perform  the  DBDEFINE  operation. 


3.  After  updating  the  catalogs,  DBDEFINE  leaves  the  text  file 

Dbdefine.txt  in  the  same  directory  as  the  current  database.  This  file 
records  the  table  definitions  used  to  define  SOL  tables  for  the 
dBASE  database  files  added  to  the  current  database.  DBDEFINE 
also  lists  the  database  files  for  which  SOL  tables  were  created  and 
those  which  it  could  not  successfully  define. 


To  see  how  the  DBDEFINE  command  works,  add  the  Codes  sample  database 
file  to  the  current  SQL  database.  To  do  this,  type: 

9GL.  DBDEFltE  Codes 

To  see  some  of  the  information  that  SQL  records  for  SQL  tables,  you  can 
look  at  the  definitions  made  in  two  SQL  catalog  tables. 

9GL.  SELECT  * 

FED"  Systabis; 

The  Systabis  catalog  table  contains  one  row  for  each  SQL  table  in  the  same 
database.  To  display  the  columns  that  the  DBDEFINE  command  has  entered 
for  the  Codes  table,  you  can  type: 

9GL.  SELECT  Coiro,  Colreme,  Coitype,  Collen 
FROM  SyscoLs 
HERE  Tbname  =  'Code?; 
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This  command  verifies  that  column  names  and  column  type  definitions 
entered  for  the  Codes  table  are  the  same  as  those  defined  in  the  database  file 
structure  (displayed  with  the  dBASE  DISPLAY  STRUCTURE  command). 


Structure  for  database:  C:Codes.cbf 


Nutber  of  data  records:  38 

Date  of  Last  ipcfate  :  Ofi/26/87 

Field  Name  Type  Width  Dec 

1  City  Character  2D 

2  Code  Character  3 


The  DBCHECK  Utility  Command 


The  DBCHECK  command  verifies  that  the  catalog  entries  for  database  files 
and  their  associated  indexes  are  up-to-date.  You  can  use  this  command  to 
verify  that  tables  accessed  in  dBASE  mode  have  not  been  changed  since  they 
were  defined  in  SQL  mode.  The  syntax  for  the  DBCHECK  command  is: 

DBCHECK  [<  .dbf  filename  >  ]; 

The  DBCHECK  command  checks  the  current  definitions  of  SQL  tables  and 
indexes  against  the  actual  structure  of  dBASE  database  files  in  the  current 
SQL  database  directory.  DBCHECK  returns  error  messages  for  every  data¬ 
base  file  that  does  not  match  its  catalog  definition. 


NOTE 

When  DBCHECK  displays  errors,  you  need  to  follow  the  steps  below: 

1.  Copy  the  database  files  and  indexes  mentioned  in  DBCHECK  error 
messages  to  another  directory  (besides  the  current  SQL  database 
directory).  If  you  do  not  make  copies  of  the  files,  they  will  be  lost 
when  you  DROP  the  corresponding  tables. 


2.  DROP  the  tables  from  the  SQL  database. 


3.  Copy  the  database  files  and  indexes  (with  names 

<  tablename.mdx >  )  back  into  the  database  directory. 


4.  Run  the  command  DBDEFINE  <  filename  >  to  redefine  the  dBASE 
database  files  as  SOL  tables. 
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Importing  and  Exporting  Data 

dBASE  IV  SQL  provides  two  commands,  LOAD  DATA  and  UNLOAD  DATA, 
that  allow  you  to  transfer  data  between  SQL  databases  and  external  non-SQL 
data  files.  These  commands  support  transfer  of  the  same  file  types  as  sup¬ 
ported  by  the  dBASE  APPEND  FROM  and  COPY  TO  commands.  These  file 
types  are: 

■  dBASE  II,  dBASE  III,  dBASE  III  PLUS,  and  dBASE  IV  database  files 

■  RapidFile  database  files  (RPD) 

■  Framework  II  database  and  spreadsheet  files  (FW2) 

■  Delimited  format  ASCII  files  (DELIMITED) 

■  System  data  format  ASCII  files  (SDF) 

■  VisiCalc  format  files  (DIF) 

■  Multiplan  spreadsheet  format  files  (SYLK) 

■  Lotus  1-2-3  format  files  (WKS) 

The  LOAD  and  UNLOAD  commands  can  be  run  in  both  interactive  and 
embedded  SQL  modes.  Data  is  imported  to  or  exported  from  SQL  tables  in 
the  current  database.  The  external  file  may  be  in  the  current  user’s  directory, 
or  in  a  different  directory  specified  by  a  path  preceding  the  filename. 

The  LOAD  Utility  Command 

The  LOAD  command  appends  data  from  an  external  file  to  the  end  of  an 
existing  SQL  table  in  the  current  database.  The  syntax  of  the  LOAD 
command  is: 

LOAD  DATA  FROM  [path]  <  filename  >  INTO  TABLE  <  table  name> 
[[TYPE]  SDF/DIF/ WKS/ SYLK/ FW2/RPD/ DBAS  Eli/ 

DELIMITED  [WITH  BLANK/ WITH  <  delimiter  >  ]]; 


If  you’re  importing  data  from  spreadsheets  or  character-delimited  files,  the 
SQL  table  structure  into  which  you’re  loading  data  will  match  the  format  of 
the  file  from  which  you’re  importing.  Spreadsheet  data  will  be  stored  in  row 
major  order  as  opposed  to  column  order. 

The  SQL  table  must  contain  as  many  columns  as  are  expected  from  the  file 
being  imported.  Column  definitions  should  correspond  to  the  length  and 
type  of  data  expected  from  the  imported  file.  The  LOAD  comm  and  will  trun¬ 
cate  data  that  does  not  fit  into  columns  when  it  is  imported. 


If  you  do  not  specify  a  file  typ  :  with  the  LOAD  command,  dBASE  IV  assumes 
import  from  a  dBASE  database  file.  For  dBASE  files,  data  is  imported  only 
for  those  fields  also  defined  as  columns  in  the  specified  SQL  table.  (Memo 
fields  are  not  copied.)  To  copy  dBASE  II  files,  you  need  to  specify  affile  type^ 
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NOTE 

Refer  to  the  APPEND  FROM  command  in  the  Language  Reference 
manual  for  additional  guidelines  on  importing  data. 


The  UNLOAD  Utility 

The  UNLOAD  command  copies  data  from  an  SQL  table  to  a  non-SQL  format 
file.  The  syntax  for  this  command  is: 

UNLOAD  DATA  TO  [path]  <  filename>  FROM  TABLE  <  table  name> 
[[TYPE]  SDF/DIF/WKS/SYLK/FW2/RPD/DBASEII/ 

DELIMITED  [WITH  BLANK/WITH  <  delimiter  ]]; 

As  with  the  LOAD  com  m  and,  if  you  do  not  specify  a  file  type  with  the  LOAD 
command,  dBASE  IV  assumes  export  to  a  dBASE  database  file.  (Use  the 
dBASE  II  file  type  to  copy  data  to  dBASE  II  files.)  Also,  for  dBASE  files, 
fields  in  the  new  database  file  are  created  with  names  and  definitions  corre¬ 
sponding  to  columns  in  the  SQL  table  being  exported.  If  you’re  exporting 
data  to  spreadsheets,  column  names  are  written  as  column  headers  in  the 
resulting  file. 

If  tables  are  secured  with  PROTECT  passwords,  you  need  to  be  the  creator  of 
a  table  or  have  SELECT  privileges  to  UNLOAD  it.  Data  is  unencrypted  auto¬ 
matically  and  copied  to  a  file  in  the  current  user’s  directory  (unless  a  path  is 
specified). 


files. 


NOTE 

Refer  to  the  dBASE  COPY  TO  command  in  the  Language  Reference 
manual  for  additional  guidelines  on  copying  data  to  foreign  format 


SQL  Security  and  Authorization 

Security  in  the  context  of  databases  is  the  way  a  database  system  protects 
data  from  unauthorized  access,  modification,  or  destruction.  dBASE  IV 
provides  security  through  a  password-protected  log-in  system,  assignment  of 
access  privileges  to  users,  and  encryption  of  data  files. 

Database  protection  in  dBASE  IV  is  set  up  by  a  system  administrator  using 
the  dBASE  PROTECT  command.  When  a  protection  scheme  is  in  place,  all 
users  must  first  log  in  with  a  password  to  gain  access  to  dBASE  IV.  After 
users  successfully  log  in  to  dBASE  IV,  the  operations  they  can  perform  are 
dictated  by  the  privileges  assigned  to  them.  In  dBASE  mode,  file  privileges 
are  specified  with  the  PROTECT  command.  In  SQL  mode,  privileges  are 
assigned  exclusively  through  the  SQL  GRANT  and  REVOKE  commands.  (See 
the  Networking  with  dBASE  IV manual  for  a  description  of  the  PROTECT 
command.)  After  PROTECT  is  installed,  database  files  defined  as  SQL  tables 
may  only  be  accessed  using  SQL  commands. 
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User  Authorization 

Before  you  can  use  the  GRANT  and  REVOKE  commands-in  SQL  mode,  you 
must  use  PROTECT  to  create  user  IDs  (log-in  names)  and  passwords.  One  of 
the  user  IDs  that  you  should  create  is  SQLDBA  This  user  ID  has  administra¬ 
tion  privileges  to  perform  any  SQL  operation  on  any  table  or  view.  Other¬ 
wise,  when  tables  are  created,  exclusive  privileges  for  operations  on  tables 
and  views  are  restricted  to  their  creator.  After  a  table  or  view  is  created,  only 
its  creator  or  the  SQLDBA  user  ID  can  assign  or  restrict  user  privileges,  or 
authorization ,  for  operations  on  the  table  or  view. 


NOTE 

Only  the  creator  or  the  SQLDBA  user  can  DROP  a  table.  The  SQLDBA 
user  ID  has  full  privileges,  including  DROP,  on  all  tables,  views, 
indexes,  and  synonyms  in  each  database. 


All  privileges  assigned  by  GRANT  and  REVOKE  are  recorded  in  the  catalog 
tables  for  the  currently  active  database. 


Data  Encryption 

An  additional  facet  of  security  that  dBASE  IV  provides  is  data  encryption. 
Data  encryption  protects  against  unauthorized  access  by  storing  the  data  on 
disk  in  an  encoded  fashion,  so  only  authorized  users  with  a  decryption  key 
can  read  it.  Even  if  unauthorized  people  get  a  copy  of  the  data,  they  still  will 
not  be  able  to  read  or  interpret  it  without  a  key.  In  SQL  mode,  tables  are 
encrypted  when  you  create  them.  Thereafter,  only  authorized  users  can 
access  the  tables. 


TEMP  clause  in  a  SELECT  statement).  Similarly,  you  cannot  use  the 
DB DEFINE  or  LOAD  command  with  database  files  encrypted  in 
dBASE  mode.  Tb  use  d BAS E-encryp ted  files,  S ET ENCRYPTION  OFF 
and  make  a  copy  (with  the  COPY  FILE  command).  Then,  use  that 
copy  for  DBDEFINE  or  LOAD  operations. 


NOTE 

Data  in  tables  created  in  SOL  mode  cannot  be  accessed  in  dBASE 
mode  unless  you  UNLOAD  data  from  the  table  (or  use  the  SAVE  TO 


The  GRANT  Command 

The  GRANT  command  grants  privileges  to  users  for  specified  tables  or  views. 
The  syntax  for  this  command  is: 

GRANT  ALL  [PRIVILEGES]/  <  privilege  list  > 

ON  [TABLE]  <  table  list> 

TO  PUBLIC/ <  user  list  > 

[WITH  GRANT  OPTION]; 
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GRANT  allows  you  to  specify  privileges  that  correspond  to  ALTER,  CREATE 
INDEX,  DELETE,  INSERT,  SELECT,  and  UPDATE  operations  on  tables. 
GRANT  privileges  are  cumulative;  that  is,  you  can  expand  existing  privileges 
by  adding  privileges  to  those  a  user  already  has.  Also,  if  users  are  granted 
GRANT  privileges  ^WITH  GRANT  OPTION),  they  can  pass  on  those  same 
privileges,  or  a  subset  of  them,  to  other  users.  Conversely,  if  a  user’s  privi¬ 
leges  are  revoked,  they  are  also  revoked  for  any  users  who  received  them 
from  that  user. 


A** 


You  can  grant  all  privileges  to  a  user  with  the  ALL  option,  or  specify  one  or 
more  privileges  separated  by  commas.  Available  privileges  are: 

■  ALTER  —  ability  to  add  columns  to  a  table 

■  DELETE  —  ability  to  delete  rows  from  a  table  or  view 

■  INDEX  —  ability  to  use  the  CREATE  INDEX  command 

■  INSERT  —  ability  to  add  rows  to  a  table  or  view 

■  SELECT  —  ability  to  display  rows  from  a  table  or  view 

■  UPDATE  —  ability  to  update  rows  in  a  table  or  view,  or  only  updatejspe- 
cific  columns 

You  can  specify  that  the  GRANT  statement  applies  to  all  users  (PUBLIC),  or 
specify  a  list  of  user  IDs  created  by  PROTECT.  For  example,  to  assign  all 
privileges  to  a  user  ID  Janice  on  the  Staff  table,  you  could  type: 


SGL.  GRANT  ALL  CN  TABLE  Staff 
TO  Janice; 


Rather  than  assigning  all  privileges,  you  could  specify  individual  privileges. 
For  example: 


90..  GRANT  INSERT,  LR3A7E,  DELETE  CN  Staff 
TO  RELIC; 


The  REVOKE  Command 


The  REVOKE  command  revokes  access  privileges  previously  granted  on 
specified  tables  or  views.  The  syntax  of  this  command  is: 

REVOKE  ALL  [PRIVILEGES]/  <  privilege  list  > 

ON  [TABLE]  <  table  list> 

FROM  PUBLIC/  <  user  list  >  ; 

You  can  revoke  all  privileges  from  specified  users  with  the  ALL  option,  or 
specify  one  or  more  privileges  separated  by  commas.  Privileges  you  can 
specify  are  the  same  as  those  listed  for  the  GRANT  command. 


For  example,  if  you  had  assigned  full  privileges  for  the  Staff  table  to  three 
users  (John,  Janice,  and  Greg),  you  could  revoke  INSERT  and  UPDATE  privi¬ 
leges  of  one  of  the  users  by  typing  the  following  command: 

90..  REVOKE  IfDATE,  INSERT  CN  Staff 
FROM  John; 
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NOTE 

REVOKE  from  PUBLIC  only  affects  privileges  previously  assigned  by  a 
GRANT  TO  PUBLIC  command. 


dBASE  IV  SQL  on  a  Local  Area  Network  (LAN) 

On  a  local  area  network,  where  users  share  access  to  files,  there  are  often 
conflicts  between  users  when  they  attempt  to  change  the  same  information 
at  the  same  time.  If  users  were  able  to  change  data  simultaneously,  the 
results  could  be  disastrous.  dBASE  IV  provides  three  different  methods  of 
resolving  these  conflicts:  exclusive  use  of  files,  locking  of  files  (for  the  dura¬ 
tion  of  an  operation),  and  locking  of  records. 

When  it  is  crucial  that  a  user  control  an  entire  file  in  dBASE  mode  (for 
example,  during  a  multiple  record  update  operation),  all  other  users  can  be 
prevented  from  updating  the  same  file.  In  contrast,  if  many  users  need  to 
have  access  to  the  same  file,  users  can  share  a  Hie  and  lock  individual 
records  only  when  they  need  to  update  them. 

While  these  concepts  are  important  for  SQL  users  to  understand,  SQL  does 
not  require  commands  to  lock  file  or  records.  File  and  record  locking  for 
SQL  commands  is  automatic.  When  a  user  executes  an  SQL  command  to 
insert,  update,  or  delete  data  in  an  SQL  table  or  view,  dBASE  IV  determines 
the  kind  of  lock  needed. 

Occasionally,  dBASE  IV  is  unable  to  complete  a  lock  operation  because  a 

resource  is  already  locked.  Another  user  may  be  executing  SQL  commands 

at  another  machine,  or  dBASE  commands  have  locked  records  or  a  database 

file.  In  cases  where  data  is  not  immediately  available,  dBASE  IV  continues 

to  try  to  lock  for  a  period  of  time-fepscififtiPwith  the  SET  REPROCESS/com  -  v/ou  o£(,Vy 

mand.  A  '  4  ’  y 

When  all  users  are  executing  only  SQL  commands,  you  will  rarely  be  unable 
to  complete  update  operations  because  of  locked  files.  However,  if  some 
users  are  running  dBASE  commands  that  access  the  same  data,  a  file  or 
record  may  be  locked  for  an  indefinite  period  and  you  may  be  locked  out. 

In  that  case,  you  will  get  a  message  indicating  that  the  operation  could  not 
be  completed. 


NOTE 

1.  You  may  want  to  check  the  status  setting  for  SET  EXCLUSIVE.  To 
maximize  concurrent  access  of  data,  SET  EXCLUSIVE  should  be 
Off 

2.  lb  prevent  situations  in  which  you  cannot  complete  an  SQL 
statement,  you  may  want  to  use  the  dBASE  BEGIN  and  END 
TRANSACTION  commands  to  make  sure  that  an  operation  is  com¬ 
pleted.  If  the  operation  was  not  completed,  you  will  be  able  to 
restore  tables  to  their  original  state.  The  next  chapter  illustrates 
how  transaction  processing  can  be  used  with  SQL  statements  that 
are  embedded  in  dBASE  application  programs. 


(W  clefpulf 
A 
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Embedding 

SQL 

Commands 


In  this  chapter,  you’ll  learn  how  to  create  dBASE  IV  SQL  programs.  You  use 
the  same  commands  in  SQL  programs  as  in  the  interactive  SQL  mode,  plus 
some  additional  commands  allowed  exclusively  in  programs. 

Embedded  SQL  refers  to  the  commands  that  allow  SQL  to  be  used  with  a 
host  programming  language.  In  mainframes  and  minicomputer 
environments,  SQL  is  often  used  to  write  database  applications  with 
languages  such  as  COBOL,  FORTRAN,  or  C.  In  dBASE  IV,  dBASE  commands 
provide  the  tools  to  build  the  application. 

In  SQL  programs,  the  dBASE  language  provides  commands  and  functions 
needed  to  do  such  tasks  as  building  menus  and  data  entry  forms,  and  print¬ 
ing  reports.  It  provides  constructs  such  as  DO  WHILE,  DO  CASE,  IF.. .ELSE, 
ON  ERROR,  and  program  memory  variables  to  control  the  processing  and 
flow  within  an  application.  dBASE  also  provides  commands  to  process  key¬ 
board  input  and  set  up  the  environment,  for  example,  to  customize  and  set 
options  for  the  display  of  data. 


What  This  Chapter  Covers 

The  topics  covered  in  this  chapter  are: 

■  Embedding  SQL  commands 

■  Creating  and  running  SQL  programs 

■  Embedding  SQL  data  definition  and  SELECT  statements 

■  Using  SQL  cursor  commands 

■  Embedding  SQL  INSERT,  UPDATE,  and  DELETE  commands 

■  Multi-user  programming  and  transaction  processing 


Preparing  for  This  Chapter 


USING  dBASE  SQL 


This  chapter  assumes  that  you’ve  already  started  dbASE  IV  and  have  the  dot 
prompt  displayed  on  your  screen.  You’ll  use  the  dBASE  IV  program  file  edi¬ 
tor,  MODIFY  COMMAND,  to  create  SQL  program  files  in  this  chapter. 
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Embedding  SQL  Commands 

dBASE  IV  provides  two  different  methods  of  accessing  data,  each  with  differ¬ 
ent  advantages.  The  first  method  is  based  on  traditional  dBASE  commands 
such  as  USE,  SELECT,  and  FIND.  Using  these  commands,  you  open  database 
files,  select  work  areas,  and  move  record  pointers  within  each  open  file  to 
access  individual  records. 

SQL  commands  in  dBASE  IV  provide  a  second  method  involving  a 
set-oriented  approach.  Instead  of  opening  files  and  manipulating  record 
pointers  to  find  data,  you  specify  the  set  of  data  you  want  to  retrieve  from  a 
table,  and  the  system  determines  how  to  find  the  information.  A  similar  set- 
oriented  approach  is  used  for  inserting,  updating,  or  deleting  data. 

You  can  choose  either  the  dBASE  or  SQL  approach  to  accessing  data,  or  you 
can  use  both.  However,  because  certain  commands  in  dBASE  and  SQL  have 
the  same  name,  and  because  of  the  differences  in  the  ways  these  two  tech¬ 
niques  access  data,  you  need  to  clearly  identify  program  files  that  contain 
SQL  com mands. 

Programs  in  which  SQL  commands  are  used  must  have  a  .prs  (program 
source)  file  extension.  Program  files  that  use  dBASE  commands  to  access 
data  normally  have  a  .prg  file  extension.  You  can  use  both  types  of  program 
files  —  dBASE  .prg  and  embedded  SQL  .prs  files  —  in  the  same  application. 
A  dBASE  .prg  file  can  call  an  embedded  SQL  .prs  file  (with  the  DO 
command)  and,  similarly,  a  .prs  file  can  call  a  .prg  file.  This  allows  you  to 
pick  the  best  method  for  your  particular  programming  application. 

You  cannot  include  SQL  commands  in  program  files  in  which  you  use 
dBASE  commands  to  open  and  access  database  files.  The  reverse  is  also  true. 
In  programs  that  contain  SQL  commands,  you  cannot  use  dBASE  commands 
and  functions  that  reference  an  open  file  or  work  area  (for  example,  USE), 
or  relate  to  use  of  the  record  pointer  (for  example,  the  RECNOQ  and  EOF() 
functions).  Appendix  C  provides  a  quick  summary  of  dBASE  IV  commands 
and  functions.  Appendix  C  also  indicates  whether  each  command  or  function 
can  be  used  in  SQL  mode. 

There  is  one  other  difference  between  the  two  types  of  files.  In  a  .prg  file, 
the  semicolon  character  is  used  only  as  a  continuation  character.  The  semi¬ 
colon  indicates  that  a  dBASE  command  continues  on  the  next  line.  In  a  .prs 
(SQL)  file,  the  semicolon  indicates  the  end  of  an  SQL  statement;  for  allowed 
dBASE  commands,  it  indicates  the  continuation  of  a  dBASE  statement  on 
more  than  one  line.  SQL  and  dBASE  statements  can  both  contain  up  to 
1,024  characters. 


dBASE  Memory  Variables 

You  can  specify  dBASE  memory  variables  in  SQL  expressions  in  WHERE 
clause  search  conditions  and  with  SQL  predicates  such  as  IN  or  LIKE.  They 
can  also  be  used  in  commands  to  transfer  data  to  columns  in  tables  with  the 
INSERT  command.  When  used  with  the  FETCH  command,  memory 
variables  receive  data  values  from  table  columns.  Values  from  dBASE  mem¬ 
ory  variables  can  also  pass  data  between  dBASE  and  SQL  mode  programs. 
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dBASE  Functions 

dBASG  functions  can  also  be  used  in  SQL  expressions,  in  the  SELECT, 
WHERE,  and  HAVING  clauses.  dBASE  functions,  in  contrast  to  SQL  func¬ 
tions,  can  operate  only  on  a  single  value  at  a  time.  Appendix  C  describes  the 
dBASE  functions  that  can  be  used  with  SQL  statements. 

You  can  also  use  user-defined  functions  (UDFs)  in  SQL  mode;  however,  you 
cannot  include  a  user-defined  function  within  an  SQL  statement.  Also,  UDFs 
cannot  include  SQL  statements.  UDFs  used  in  SQL  mode  can  only  contain 
dBASE  commands  and  functions  allowed  in  SQL  mode. 

SQL  Error  Handling 

When  executing  SQL  commands  from  a  dBASE  program  file,  you  can  specify 
error  handling  using  the  dBASE  ON  ERROR  command.  (Refer  to  Appendix  A 
for  a  list  of  the  errors  trapped  by  the  ON  ERROR  command  in  SQL  mode.) 
You  can  create  specific  error  handling  routines  depending  on  the  different 
error  numbers  that  an  SQL  program  returns. 

SQL  also  provides  two  system  memory  variables,  Sqlcnt  and  Sqlcode,  that 
determine  the  outcome  of  SQL  operations.  Sqlcode/^ olds  a  value  that  indi¬ 
cates  the  outcome  of  the  last  SQL  operation.  It  takes  on  one  of  three  differ¬ 
ent  values.  A 


Table  6-1  Sqlcode  values 


Value  Description 

0  Indicates  successful  completion  of  an  SQL  command 

-1  Indicates  an  execution  error  occurred  or  the  current  user  did 

not  have  sufficient  privileges  to  execute  the  command 

[+100  Last  operation  returned  no  rows,  SELECT  in  an  INSERT  state¬ 

ment  returned  no  rows,  UPDATE  or  DELETE  statement  did  not 
update  or  delete  any  rows,  or  FETCH  is  attempted  past  the  last 
row  of  a  result  table 


You  can  use  the  value  of  Sqlcnt  to  check  whether  an  SQL  operation  was 
successfully  completed.  For  example,  using  the  FETCH  command,  you  can 
check  whether  the  last  operation  returned  any  rows  you  need  to  process. 

The  Sqlcnt  variable  holds  a  value  indicating  the  number  of  rows  affected  by 
the  last  SQL  operation.  For  example,  if  an  UPDATE  operation’s  WHERE 
clause  limited  updated  rows  to  six,  Sqlcnt  would  hold  a  value  of  six  follow¬ 
ing  completion  of  the  command.  You  may  want  to  use  the  values  returned  by 
Sqlcnt ,  for  example,  to  determine  when  you  need  to  run  the  RUNSTAfsJcom- 
mand. 
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Creating  and  Running  SQL  Programs 

A  dBASE  IV  program  is  a  sequence  of  SQL  and  dBASE  statements  in  one  or 
more  ASCII  text  files.  These  files  are  separate  from  the  database  files  or 
tables  maintained  by  dBASE  IV,  which  are  referenced  within  the  programs. 

To  create  program  files  in  dBASE  IV,  you  can  use  the  dBASE  MODIFY 
COMMAND  text  editor  or  any  other  editor  that  produces  ASCII  text  files. 
(See  Chapter  11  in  Using  the  Menu  System  for  a  description  of  the  MODIFY 
COMMAND  editor.)  If  you’re  creating  an  embedded  SQL  program,  remem¬ 
ber  to  label  the  file  with  a  prs  file  extension. 


NOTE 

You  can  substitute  a  different  editor  for  the  built-in  MODIFY 
COMMAND  editor  by  using  the  TEDIT configuration  command  in  your 
Conffg.db  file. 


Depending  on  how  you  structure  your  dBASE  IV  application,  you’ll  need  to 
create  one  or  more  program  files  that  contain  dBASE  and  SQL  statements. 
Besides  entering  dBASE  or  SQL  statements,  you  can  also  embed  program 
comments  by  prefacing  them  with  the  *  and  &&  characters,  and  the  NOTE 
command. 

You  can  also  structure  your  dBASE  application  to  contain  dBASE  procedure 
files.  Procedure  files  are  named  the  same  as  other  program  files.  Procedure 
files  that  contain  procedures  using  only  dBASE  commands  are  named  with 
the  .prg  extension.  Procedure  files  that  contain  procedures  including  SQL 
statements  must  be  named  with  a  .prs  extension. 

Once  you’ve  created  the  program  files  for  your  application,  you  can  run  your 
application  by  typing  DO  <  filename >  .  The  first  time  you  run  an  applica¬ 
tion,  the  DO  command  first  compiles  the  program  files  in  the  application 
before  beginning  to  execute  it.  dBASE  IV  then  loads  the  specified  main  pro¬ 
gram  into  memory  and  begins  executing  its  commands.  During  the  execu¬ 
tion  of  an  application  program,  dBASE  program  files  can  call  SQL  program 
files  and  procedures,  and  vice  versa.  dBASE  IV  automatically  switches 
modes  depending  on  the  extension  of  the  file  it  encounters.  When  dBASE  IV 
switches  from  dBASE  mode  to  SQL  (or  SQL  to  dBASE  mode)  to  execute  a 
called  program  or  return,  it  restores  the  environment  (work  areas,  open 
files,  and  SET  command  directives)  previously  set  in  that  mode. 

A  total  of  ten  work  areas  are  available  in  dBASE  IV.  When  dBASE  IV 
switches  to  SQL  mode,  any  work  areas  in  use  remain  open.  To  minimize  the 
possibility  of  running  out  of  work  areas,  you  should  close  any  unnecessary 
open  files  before  switching  to  SQL  mode.  The  following  guidelines  describe 
SQL’s  use  of  work  areas  for  execution  of  SQL  commands. 

■  One  work  area  is  required  for  each  table  referenced  in  a  SELECT  query, 
subquery,  or  self-join. 

■  An  additional  work  arsa  is  required  for  each  open  cursor  (specified  by 
the  OPEN  <  cursor  name>  command).  Work  areas  used  by  open  cur¬ 
sors  remain  open  during  subsequent  execution  of  program  files  that 
switch  to  dBASE  mode.  Work  areas  are  released  when  the  CLOSE 

<  cursor  name  >  com  mand  is  issued. 
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■  An  additional  work  area  is  required  for  each  GROUP  BY  or 
ORDER  BY  clause. 

■  Additional  work  areas  are  opened  for  temporary  file  creation  and  access 
of  catalog  tables  during  the  execution  of  SELECT  queries  and  transac¬ 
tions  (commands  executed  in  BEGIN. ..END  TRANSACTION  blocks). 

There  are  additional  dBASE  commands  you  can  use  after  you’ve  created 
your  application  program.  If  you  encounter  errors  in  executing  your  applica¬ 
tion,  you  can  use  the  test  and  debugging  environment  provided  by  the  SET 
TRAP  and  DEBUG  commands.  You  can  use  the  COMPILE  command  to  com¬ 
pile  dBASE  programs  into  dBASE  object  code  format  without  executing  the 
resulting  code  (unlike  the  DO  command).  To  link  program  object  modules 
into  a  single  file,  use  DBLINK,  the  DOS-level  linker.  The  RunTime  program 
lets  you  package  a  run-time  version  of  dBASE  IV  with  your  application  pro¬ 
gram  object  files.  Finally,  the  BUILD  DOS-level  command  combines  opera¬ 
tion  of  the  compiler,  linker,  and  RunTime  program.  It  allows  you  to  create 
an  executable  version  of  your  application,  complete  with  RunTime  program 
modules,  and  copy  the  files  to  a  floppy  disk. 


Embedding  Data  Definition  Statements 

The  largest  group  of  SQL  statements  that  can  be  embedded  in  an  SQL  pro¬ 
gram  is  the  group  of  data  definition  statements.  These  statements  define  or 
drop  tables,  views,  synonyms,  and  indexes.  In  a  program,  database  objects 
are  normally  defined  first.  You  can  then  query  or  update  them.  You  may 
want  to  define  tables  and  views,  for  example,  as  part  of  an  installation  or 
maintenance  procedure,  or  perhaps  to  generate  reports.  Table  6-2  lists  the 
data  definition  statements. 


Table  6-2 

Data  definition  statements 

Command 

Description 

ALTER  TABLE 

Add  columns  to  a  table 

CREATE  INDEX 

Create  an  index  based  on  the  columns  in  a  table 

CREATE  SYNONYM 

Create  an  alternate  name  for  a  table  or  view 

CREATE  TABLE 

Create  a  base  table 

CREATE  VIEW 

Create  a  view  based  on  one  or  more  tables  or  views 

DROP  INDEX 

Drop  an  index 

DROP  SYNONYM 

Drop  a  synonym 

DROP  TABLE 

Drop  a  table  and  any  views  or  synonyms  based  on 
that  table 

DROP  VIEW 

Drop  a  view 

USING  dBASE  SQL 
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The  syntax  of  these  commands  in  an  embedded  SQL  program  is  the  same  as 
when  you  execute  the  commands  interactively. 

Related  to  the  data  definition  statements  are  the  two  authorization 
commands,  GRANT  and  REVOKE,  that  define  privileges  for  each  of  the 
defined  data  objects.  After  you  create  data  objects,  you  may  want  to  specify 
privileges  to  users  and  have  your  program  check  those  privileges  when  users 
perform  an  operation.  (This  assumes  that  you’ve  defined  user  IDs  with 
PROTECT.) 


Embedding  SELECT  Statements 

The  most  powerful  embedded  SQL  statement  is  the  SELECT  statement. 

When  embedded  in  SQL  programs,  tne  SELECT  statement  can  do  the 

following: 

■  Display  data  from  a  table  or  view 

■  Transfer  selected  column  values  from  a  single  row  to  dBASE  memory 
variables 

■  Transfer  selected  column  values  from  selected  rows  to  dBASE  memory 
variables,  a  row  at  a  time,  using  SQL  cursor  commands 

■  Update  selected  column  values  or  delete  selected  rows  using  the  SQL 
cursor  commands 


Embedding  SELECTS  to  Display  Data 

You  can  use  a  SELECT  statement  in  an  SQL  program  to  display  data  on  the 
screen,  just  as  you  would  if  you  executed  the  SELECT  command  in  the  inter¬ 
active  SQL  mode.  The  following  code  example  shows  how  to  display  differ¬ 
ent  queries  of  the  Staff  table: 

DO  CASE 
* 

CASE  mchoice  =  1 


WAIT  "Press  any  key  to  display  the  employee  with  hipest  salary' 
* 

SELECT  Lastname,  Salary 
FRCM  Staff 
W£RE  Salary  = 

(SELECT  MAX  (Salary) 

FRCM  Staff); 


BOCASE 

You  can  use  dBASE  memory  variables  in  the  SELECT  statement  anywhere 
that  you  can  use  a  constant  (for  example,  in  the  WHERE  clause).  Using  a 
dBASE  memory  variable  in  the  WHERE  clause,  you  could  specify  a  query 
matching  rows  in  a  table  against  the  value  in  the  memory  v ariabte|( Mloca - 
non  —  "NY0),  as  in  the  following  example: 
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SELECT  * 

FRCM  CLe  toner 

WERE  State  =  mlocaticn 

ORDER  BY  Corpany; 


Transferring  a  Single  Row 

For  single-row  SELECTS,  the  SELECT  statement  has  an  additional  INTO 
clause  that  you  can  use  to  transfer  a  single  row  of  column  values  into  corre¬ 
sponding  dBASE  memory  variables.  The  SELECT  statement  must  only  select 
one  row.  The  system  will  check  the  number  of  rows  selected  by  a  SELECT 
statement  with  an  INTO  clause.  If  more  than  one  row  is  selected,  an  error 
message  appears. 

For  example,  to  retrieve  client  information  from  the  Customer  table  (passing 
those  values  to  a  dBASE  program),  you  could  execute  the  following  program 
code  segment: 

ACCEPT  "Biter  customer's  last  name:  "  TO  mcustomer 
SELECT  Firstoame,  Lastname,  Address,  City,  State,  Zip 
INTO  mfrato^lrame/nadd-^ity^Btate/iEip 
FROM  Customer 

U-ERE  IPFERCLastname)  =  LPPER (Mcustomer); 

* 

DO  Subprgl  WITH  mfname,  mlname,  maddr,  mcity,  mstate,  mzip 

In  this  example,  the  ACCEPT  statement  stores  the  entry  of  a  customer’s  last 
name  in  a  memory  variable  named  mcustomer.  The  value  of  this  memory 
variable  is  used  inside  the  SELECT  statement’s  WHERE  clause  to  find  a  cus¬ 
tomer  with  the  same  name.  That  information  is  then  passed  to  a  subprogram 
using  values  stored  in  memory  variables. 


Returning  Multiple  Rows 

The  most  widely  used  embedded  SELECT  statement  is  one  that  returns  mul¬ 
tiple  rows  to  a  database  program  through  memory  variables.  SQL  uses  a 
cursor  to  return  column  values  from  selected  rows,  one  row  at  a  time.  The 
SQL  cursor  is  similar  to  the  record  pointer  in  dBASE.  However,  the  SQL  cur¬ 
sor  only  points  to  rows  in  the  SELECT  statement’s  result  table.  Also,  the  SQL 
cursor  can  only  be  advanced  in  a  forward  direction,  one  row  at  a  time. 

Column  values  of  the  current  row  are  placed  in  memory  variables  that  corre¬ 
spond  to  columns  named  in  the  SELECT  clause  by  a  FETCH  statement.  The 
four  cursor  command  statements  are  listed  below. 

■  DECLARE  <  cursor  name>  CURSOR  FOR  defines  a  cursor.  Associated 
with  each  cursor  is  the  embedded  SELECT  statement  that  returns  multi¬ 
ple  rows.  The  SELECT  statement  defines  the  rows  in  a  result  table  that 
the  cursor  will  step  through. 

■  OPEN  <  cursor  name>  executes  the  SELECT  statement  associated  with 
the  cursor  to  create  a  result  table.  It  sets  the  cursor  to  the  position 
before  the  first  row  of  the  result  table  (or  at  the  end  of  file  if  the  result 
table  is  empty). 
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■  FETCH  <  cursor  name>  INTO  <  memvar  list >  advances  the  cursor  to 
the  next  selected  row,  then  transfers  column  values  from  the  row  to  cor¬ 
responding  program  memory  variables. 

■  CLOSE  <  cursor  name>  closes  the  cursor  and  releases  the  work  area 
and  memory  it  uses.  You  may  reopen  a  cursor  after  it  has  been  closed.  If 
you  reopen  the  cursor,  its  associated  SELECT  statement  is  executed 
again  to  produce  a  new  result  table. 

For  example,  you  can  use  SQL  cursors  and  an  embedded  SELECT  statement 
to  identify  rows  of  orders  in  the  Sales  table  that  have  not  been  invoiced.  You 
can  pass  the  order  information  to  an  SQL  subprogram  that  joins  the  row 
with  information  from  the  Item  and  Inventry  tables  to  generate  all  the  infor¬ 
mation  for  an  invoice. 

DECLARE  Irv  CLR90R  FCR 

SELECT  Order_rx>,  Sale_cfete,  Staff_no,  Custno, 

FRCM  Sales 
WHERE  NOT  Invoiced; 


CFEY  Irv; 


DO  WHILE  .T. 

FETCH  Inv  INTO  rorder_no,  msalejjate,  mstafLro,  mcust_ro; 
IF  9QLC00E  =  0 


DO  Irvoice  WITH  nrorder_po,  msa  legate,  mstaff_ro,  mcust_ro 


ELSE 
EXIT 
BDIF 
EEND0Q 
CLJSE  Inv; 


<  cursor  name  >  command  to  change  the  value  of  the  logical 
Invoiced  column  to  true,  or  use  the  DELETE  WHERE  CURRENT  com¬ 
mand  to  delete  an  entire  row  after  invoicing  it. 


Embedding  UPDATE  Statements 

The  SQL  UPDATE  statement  changes  values  of  columns  in  selected  rows  of  a 
table  or  view.  There  are  two  ways  you  can  embed  the  UPDATE  statement. 
You  can  use  the  UPDATE  command  with  the  same  syntax  as  in  the  interac¬ 
tive  SQL  mode,  or  you  can  use  UPDATE  with  SQL  cursor  statements. 


NOTE 

You  can  also  delete  or  update  information  using  cursors.  For  example, 
you  could  use  the  UPDATE  <  table  >  WHERE  CURRENT  OF 
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For  example,  to  update  the  Commission  column  for  all  rows  of  the  Staff 
table  where  the  salesperson  is  located  in  New  York,  you  could  type: 

ACCEPT  "  Biter  percent  camrissicn  increase''  TO  mcarm 
IPOATE  Staff 

SET  Camrissicn  =  Camrissicn  +  mcarm 
WHERE  State  =  "NT; 


NOTE 

You  can  use  dBASE  memory  variables  with  the  UPDATE  statement 
anywhere  that  you  can  use  a  constant,  for  example,  in  the  WHERE 
clause.  Using  a  dBASE  memory  variable  in  the  WHERE  clause,  you 
could  update  rows  in  a  table  where  a  particular  column  value 
matches  the  value  of  the  memory  variable. 


To  use  UPDATE  with  SQL  cursors,  you  use  a  form  of  the  command 
UPDATE...WHERE  CURRENT  OF,  which  allows  you  to  update  the  row 
pointed  to  by  the  cursor.  For  example,  you  can  modify  the  code  segment 
used  previously  to  generate  invoices  for  uninvoiced  orders: 


DECLARE  Inv  CLR90R  FCR 

SELECT  Order_ro,  Salejfcte,  Staff_po/  Custom,  Invoiced 

TOM  Sales 

WERE  NOT  Invoiced 

FOR  IPOATE  OF  Irv; 


CFBI  Irv; 

DO  WHILE  .T. 

FETCH  Irv  INTO  morder_po,  msale_date,  mstaff.no,  mcust_po,  mirvoiced; 
IF  9QLC0DE  =  0 

"M  rint  an  invoice  for  order  nurber  in  the  or  rent  row 
*  ]  f  successful,  change  Minvoiced  memory  variable  to  .T. 


DO 


Invoice  WITH  morderjno,  msale_date,  mstaff_no,  mcust_no,  mirvoiced 


0HHF 


nrinvoiced 
ATE  Sales 
Invoiced  =  .T. 

RE  CURRENT  OF  Irv; 


CLOSE  Inv; 
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In  this  example,  the  Invoice  program  generates  an  invoice  for  the  order 
number  in  the  row  pointed  to  by  the  cursor.  After  completing  the  invoice, 
the  Invoiced  column  in  the  current  row  is  updated  to  true.  WHEREjCUR 
RENT OFInv  selects  the  current  row  of  the  specified  cursor’s  result  table 


Embedding  DELETE  statements 

The  SQL  DELETE  statement  deletes  selected  rows  of  a  table  or  view  As  with 
the  SQL  UPDATE  statement,  there  are  two  ways  you  can  embed  the  DEI.l.TF: 
statement.  You  can  use  the  same  syntax  as  in  the  interactive  SQL  mode,  or 
you  can  use  DELETE  with  SQL  cursor  statements. 

For  example,  to  delete  all  rows  in  which  the  order  has  been  invoiced  and 
was  placed  before  9/22/87,  you  could  type: 

DELETE 
FRCM  Sales 

VHERE  Invoiced  AN)  Sale_date  <  CTODC09/22/8T); 


NOTE 

You  can  use  dBASE  memory  variables  in  the  DELETE  statement  any¬ 
where  that  you  can  use  a  constant.  For  example,  using  a  dBASE  mem¬ 
ory  variable  in  the  WHERE  clause,  you  could  delete  rows  in  a  tabic  in 
which  speciffed  columns  match  the  value  in  the  memory  variable 
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Tb  use  the  DELETE  statement  with  SQL  cursors,  you  use  a  form  of  the  com¬ 
mand  DELETER. ^.^rWHERE  CURRENT  OF,  which  will  delete  the  row 
pointed  to  by  the  cursoV!  For  example: 

DECLARE  Inv  CURSOR  FOR 

SELECT  Order_pD,  Salejiate,  Staff  _po,  CUstjno,  Invoiced 

FROM  Sales 

IrtRE  NOT  Irvoiced; 


CPBJ  Irv; 


DO  VHILE  .T. 

FETCH  Inv  INTO  morder_po,  msale_date,  mstaffjx)/  mcu5t_ro,  m invoiced; 
IF  SOLCOOE  =  0 

*  P  “irrt  an  irvoice  for  order  rutber  in  the  arrerrt  raw 

*  I :  successful,  change  Hinvoiced  memory  variable  to  .T. 

* 

DO  hvoices  WITH  mDrder_po,  msale_£fate,  mstaffjno,  mcust_ro,  minvoiced 


F  mirvoiced  .AM).  Sale_date  <  CTODC  09/22/87') 
DELETE  FROM  Sales 
VHERE  CURRBfT  OF  Inv; 


^  qOIF 


EXIT 

BDIF 
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Embedding  INSERT  statements 

You  can  also  embed  the  INSERT  statement  in  programs.  For  example,  the 
following  program  code  segment  shows  how  you  could  create  a  dBASE  data 
entry  form  and  insert  validated  new  rows  to  the  Inventry  table. 

DO  VHILE  .T. 

* 

3  3,20  SAY  "Add  items  to  Invent  ry  table'' 

3  5,8  SAY  "Biter  5-digit  part  nuiber"  GET  npart_ro 
a  6/8  SAY  "  Biter  a  part  description  GET  mdescript 
3  7/8  SAY  "Biter  the  quantity  cn  hard'  GET  monjiand 
3  8/8  SAY  "Biter  the  stock  location  GET  mlocaticn 
3  9/8  SAY  "Biter  the  part's  unit  cost'  GET  nuiitcost 
310,8  SAY  "Biter  0  in  the  part  rurber  field  to  exit' 

* 

READ 

* 

IF  rrpart_no  =  0 
EXIT 
^OIF- 

select  OOLNTC*) 

INTO  Lmatch 
FRCM  Inventry 

WHERE  Location  =  mlocaticn  AN)  PartJno  =  npartLPo; 

* 

*  Add  new  row  if  location  is  new  for  existing  part 

* 

IF  Uratch  =  0 
f  INSERT  INTO  Irwitry 

J  CPartLno,  Descript,  ChJhand,  Locaticn,  Ihitoost) 

VALUES  (rrpart_no,  mdescript,  mcnJiand,  mlocaticn,  nuiitcost); 

* 

_ j-  *  F^rt  nurber  and  locaticn  are  not  oiiqje 

ClapiF 

BDIF 

A 

In  this  example,  new  rows  are  added  in  two  different  situations:  when  the 
part  number  you’ve  entered  is  new,  or  when  you  enter  a  new  stock  location 
for  an  existing  part.  Otherwise,  the  program  loops  back  to  display  the  entry 
form  without  entering  a  row. 


Multi-User  and  Transaction  Programming 

The  embedded  SQL  programs  you  create  will  automatically  run  on  worksta¬ 
tions  operating  dBASE  IV  on  a  local  area  network  (LAN).  When  more  than 
one  person  is  running  dBASE  IV,  data  files  are  automatically  locked  during 
SQL  operations  that  insert,  update,  or  delete  data.  You  can  specify  a  value 
with  the  SET  REPROCESS  command  so  that  dBASE  IV  will  retry  an  opera¬ 
tion  automatically  if  a  database  table  is  locked  because  someone  else  is 
inserting,  updating,  or  deleting  data, 


^Ea/DDO 
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Occasionally,  dBASE  IV  is  unable  to  complete  a  lock  operation  because  a 
resource  is  already  locked.  Another  user  may  be  executing  SQL  commands 
at  another  machine,  or  dBASE  commands  have  locked  records  or  a  database 
file.  Tb  prevent  situations  in  which  you  cannot  complete  an  SQL  statement, 
you  may  want  to  use  the  dBASE  BEGIN  and  END  TRANSACTION 
commands.  You  can  then  make  sure  that  an  operation  is  completed  or,  if  it 
is  not  completed,  restore  a  table  to  its  original  state.  The  following  example 
shows  the  setup  of  a  transaction. 

CN  ERROR  DO  Reaver 
SET  REFROCESS  TO  15 
BEGIN  TRANSACTS 
LPOATE  Staff 

SET  Gcnnrissicn  =  Camrissicn  +  mcanm 
WERE  State  =  "NT; 

BO  TRANSACTION 
ON  ERROR 
IF  CCMFLETEDO 

9  21,15  SAY  "Transaction  successfully  caipletecf 
BOIF 


include  them  in  a  transaction. 


NOTE 

SOL  uses  transaction  processing  internally  to  process  CREATE,  DROP, 
ALTER  GRANT,  and  REVOKE  commands:  therefore,  you  may  not 


The  dBASE  ON  ERROR  command  is  normally  used  to  handle  situations 
where  the  SQL  transaction  produces  an  error.  For  example,  you  might  set  up 
the  following  error  recovery  procedure. 


PROCEDURE  Reaver 

321.15  SAY  "Yar  transaction  has  encountered  an  error  ocnditiaf 

322.15  SAY  "  Do  you  vent  to  RETRY?  CY/NT  GET  choice  PICTURE  * !" 
READ 

9  21,15  TO  22/5  CLEAR 
IF  choice  =  "Y" 


RETRY 

ELSE 


321/15  SAY  "Rolling  back  i 


BDIF 

RETUN 


In  this  example,  dBASE  IV  attempts  to  perform  the  SQL  UPDATE  command 
specified  in  the  transaction.  If  successful,  it  displays  the  message 
Transaction  successfully  completed.  However,  if  an  error  occurs,  the 
PROCEDURE  Recover  is  called.  The  Recover  procedure  allows  the  user  two 
options:  one  to  retry  and  proceed  with  the  update,  and  a  second  option  to 
discontinue  the  operation  and  ROLLBACK  any  updates  made  to  the  table 
before  the  error  occurred. 
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Introduction 


Networking  with  dBASE  IV  describes  how  to  use  dBASE  IV™  in  a  Local 
Area  Network  (LAN)  environment.  Networking  allows  two  or  more  micro¬ 
computers  to  share  valuable  hardware,  software,  and  data. 


Local  Area  Networks 

The  microcomputers  and  peripherals  in  a  local  area  network  are  connected 
by  cables,  which  provide  a  common  communication  resource.  Each 
microcomputer  on  a  network  can  use  shared  peripheral  devices,  such  as 
large-capacity  disk  drives,  tape  storage  units,  printers,  plotters,  and  scanners. 
Network  microcomputers  can  also  share  programs  and  data. 

Figure  i-1  shows  one  way  microcomputers  and  peripherals  can  be  connected 
in  a  LAN  environment. 
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Figure  i-1  The  local  area  network  (LAN)  environment 


NETWORKING  WITH  dBASE  IV 


M 


JOBNAME:  No  Job  Name  PAGE:  2  SESS:  4  OUTPUT:  Fri  Jun  17  13:10:17  1988 
CLS:  manhat  GRP:  manhat  JOB:  mannet  DIV:  nintro 


In  a  network,  at  least  one  microcomputer  is  designated  as  the  file  server.  The 
file  server  manages  communication  and  the  sharing  of  peripheral  devices. 

The  microcomputers  managed  by  a  file  server  are  called  workstations.  Work¬ 
stations  are  also  referred  to  as  network  nodes. 

In  a  LAN  environment,  users  with  different  levels  of  expertise  and  need  can 
work  with  dBASE  IV.  Some  will  only  need  to  enter  data  or  use  application 
programs.  Others  will  program  in  dBASE  IV,  creating  database  files  and 
application  programs.  Others  will  have  the  reponsibility  of  administrating 
or  maintaining  the  network.  This  manual  provides  different  information  and 
reading  requirements  for  each  level  of  expertise. 


Sharing  Resources 

The  purpose  of  a  local  area  network  is  to  share  resources  such  as  the 
following: 

■  dBASE  IV  and  other  software  products,  which  are  set  up  as  shared 
applications 

■  Centralized  database  and  index  files,  which  eliminate  redundant  data, 
transferring  data,  and  the  need  for  multiple  updates 

■  Peripheral  devices,  such  as  disk  drives,  tape  storage  units,  printers, 
plotters,  and  scanners 

In  a  local  area  network,  a  shared  application  program  is  loaded  into  the 
workstation  from  the  file  server.  Data  files  can  be  on  the  shared  file  server 
disk  or  on  a  non-shared  workstation,  but  the  program  is  executed  at  the 
workstation.  If  the  program  needs  data  from  the  file  server,  the  system 
transmits  the  data  over  the  network.  Although  resources  are  shared,  your 
task  executes  on  your  workstation.  Because  other  users  run  tasks  on  their 
own  workstations,  their  work  does  not  slow  yours. 


About  This  Manual 

Before  using  this  manual,  your  network  should  be  installed  according  to  the 
instructions  in  the  Network  Installation  manual. 

This  manual  is  written  for  three  types  of  network  personnel:  users,  program¬ 
mers,  and  administrators.  A  section  is  provided  for  each  type.  The  Appendix 
lists  error  messages  specific  to  the  network  environment,  while  the  Glossary 
contains  a  list  of  networking  terms.  For  general  dBASE  IV  terminology,  refer 
to  the  Glossary  in  Learning  dBASE  IV.  This  manual  ends  with  a  thorough 
index,  to  help  you  quickly  look  up  a  specific  term  or  concept. 

Chapter  1,  “Using  the  Network,”  describes  how  to  log  in  to  dBASE,  share 
printers,  and  share  files.  This  chapter  also  explains  basic  file  locking  and 
record  locking  concepts,  and  describes  dBASE  commands  useful  to  a 
network  user. 
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Chapter  2,  “dBASE  Network  Programming  Concepts,’’  provides  the 

following: 

■  Basic  programming  techniques  for  supplying  data  protection  in 
a  LAN  environment 

■  A  description  of  the  refresh  capability,  which  automatically  updates 
database  information  to  show  changes  made  by  other  network  users 

■  Procedures  for  creating  programs  that  will  run  in  both  single-user 
and  multi-user  LAN  environments 


Chapter  3,  “Transaction  Processing,’’  describes  how  you  can  create  a 
transaction  log  file  of  all  changes  to  database  files  and,  if  necessary,  recover 
your  database  files  using  the  transaction  log  file. 

Chapter  4,  “Networking  Commands  and  Functions,”  describes  the  syntax, 
defaults,  and  behavior  of  each  dBASE  command  and  function  as  it  is  used  in 
programming  for  a  LAN  environment. 

Chapter  5,  “dBASE  Security,”  describes  techniques  for  defining  and  main¬ 
taining  system  security,  such  as  creating  passwords  and  protecting  data  files. 


Conventions  Used  in  This  Manual 

Understanding  the  information  in  dBASE  IV  documentation  is  easier  when 

you  are  aware  of  the  following  conventions: 

■  The  word  press  is  used  for  keys  you  press;  the  word  type  or  enter  is  used 
for  information  you  must  type  in. 

■  Function  keys  (in  the  dedicated  keypad  on  your  keyboard)  are  shown  by 
themselves  (FI)  or  with  their  assigned  functions  (FI  Help). 

■  Commands  or  entries  that  you  type  appear  in  a  different  typeface  and 
color. 

■  Instructions  to  press  the  RETURN  or  ENTER  key  are  represented  by  the 
«-•  symbol. 

■  Italics  are  used  for  new  terms  when  they  first  appear,  and  also  for 
emphasis  within  the  text. 

■  Menu  names  and  items,  messages  you  receive  from  the  program,  and 
other  on-screen  references  are  in  bold  type. 

■  Program  listings  appear  in  a  different  typeface,  with  a  shaded 
background. 

■  Displays  of  computer  screens  and  illustrations  show  the  correct  results 
of  your  instructions  to  the  program,  or  clarify  a  definition  or  instruction. 

■  Notes  and  tips  are  in  italics,  with  special  marks,  so  you’ll  be  sure  to  see 
them.  Warnings  have  lines  above  and  below  their  text,  in  addition  to  the 
warning  mark,  and  thus  stand  out  even  more. 

Notes  explain  exceptions  to  or  provide  additional  information  about  gen¬ 
eral  rules.  Tips  give  you  helpful  hints  or  shortcuts.  Warnings  help  you 
avoid  disastrous  events  such  as  losing  data. 
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Using  the 
Network 


About  This  Chapter 

This  chapter  describes  concepts  important  to  a  network  user,  that  is,  anyone 
who  uses  a  workstation  on  a  local  area  network  (LAN).  This  chapter  includes 
information  on  the  following  topics: 

■  User  procedures  for  logging  in  to  dBASE® 

■  Groups  and  how  the  group  name  you  specified  at  login  may  prohibit  you 
from  using  some  dBASE  files 

■  Locking  concepts  and  how  file  and  record  locking  may  temporarily 
prohibit  access  to  a  file  or  a  field  in  a  file 

■  dBASE  commands  that  are  useful  to  a  network  user 


Logging  In  to  dBASE 

To  start  dBASE  IV,  enter  the  DBASE  command  at  the  DOS  prompt: 

F  >  DBASE  «-* 

or  enter  the  DBASE  command  followed  by  the  name  of  the  application 
program  you  want  to  start: 

F  >  DBASE  <  filename  > 

If  your  dBASE  IV  is  not  PROTECTed,  the  copyright  notice  appears  followed 
by  the  Control  Center.  If  you  specified  an  application  program  name  with 
the  DBASE  command,  that  program  starts  and  the  Control  Center  does  not 
appear. 

If  your  dBASE  IV  is  PROTECTed,  when  you  enter  the  DBASE  command,  the 
log-in  screen  appears  (see  Figure  1-1). 
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dBASE  IU  Login 


Entar  group  none: 
Enter  passuord> 


Figure  1-1  dBASE  IV  user  log-in  screen 

You  must  enter  a  valid  user  login  to  access  the  system.  A  user  login  consists 
of  a  user  group  name,  a  log-in  name,  and  a  password. 

Enter  your  user  group  name,  log-in  name,  and  password.  The  password  does 
not  appear  on  the  screen. 

If  you  make  a  mistake,  you  will  not  be  granted  access,  and  you  will  need  to 
re-enter  all  three  log-in  items.  You  get  three  tries  to  type  your  log-in  informa¬ 
tion  correctly.  If  the  information  is  still  not  correct,  dBASE  IV  exits  to  the 
operating  system. 

If  you  log  in  correctly,  the  dBASE  IV  copyright  notice  appears,  followed  by 
the  Control  Center. 

If  you  want  to  use  dBASE  IV  from  the  dot  prompt,  select  Exit  to  dot  prompt 
from  the  Control  Center  Exit  menu. 


Understanding  Groups 

Your  database  administrator  may  have  assigned  files  to  groups  for  security 
purposes.  The  group  name  you  enter  on  the  dBASE  log-in  screen  limits  the 
database  files  you  can  access.  If  you  are  denied  access  to  a  file,  you  may  not 
belong  to  the  group  allowed  to  access  that  file.  Ask  your  network  administra¬ 
tor.  You  may  be  given  a  login  with  a  different  group  name  that  will  allow  you 
to  access  the  file  you  want.  Each  database  file  can  be  accessed  by  only  one 
group. 
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Locking  Concepts 

In  a  LAN  environment,  database  files  are  shared  with  other  network  users. 
When  you  are  using  dBASE  IV,  another  user  may  want  to  update  the  file  or 
record  that  you  are  updating.  The  system  includes  file  locking,  so  that  two 
users  cannot  update  a  file  at  the  same  time,  and  record  locking,  so  that  two 
users  do  not  update  a  record  at  the  same  time.  These  locks  occur  automati¬ 
cally  when  you  enter  information  to  modify  a  file  or  record,  that  is,  when 
you  are  using  a  BROWSE,  CHANGE,  or  EDIT  command  and  you  press  any 
key  that  changes  a  record. 

After  you  complete  your  update  and  press  a  navigation  key  to  move  to 
another  file  or  record,  dBASE  IV  automatically  releases  the  file  or  record  so 
other  users  can  update  it.  Locking  does  not  prevent  you  from  viewing  a  file 
or  a  record  that  another  user  is  updating. 

The  following  sections  describe  what  to  do  when  you  encounter  a  locked  file 
or  record. 


Locked  Files 

If  you  attempt  to  open  a  file  that  another  user  has  already  opened  for 
exclusive  use,  or  attempt  to  lock  a  file  that  another  user  has  already  locked, 
this  error  message  appears:  File  is  in  use  by  <  name  >  .  Retrying  lock, 
press  Esc  to  cancel.  dBASE  IV  tries  to  lock  the  file  repeatedly.  If  you  press 
Esc,  dBASE  IV  stops  trying  to  lock  the  file. 

\ltematively,  the  system  may  shouw  the  error  message  File  is  in  use  by 
another.  Retrying!  If  you  select  RETRY,  dBASE  IV  tries  to  lock  the  file 
again.  If  the  lock  still  is  not  granted,  the  error  message  reappears.  Try  to 
access  the  file  later.  If  you  select  ABORT,  dBASE  IV  cancels  your  request  to 
open  the  file.  Select  HELP  to  obtain  additional  information. 

Locked  Records 

If  you  attempt  to  update  a  record,  the  system  attempts  to  lock  that  record 
and  all  related  ones.  If  another  user  has  already  locked  that  record  or  a 
related  one,  this  error  message  appears:  Record  is  in  use  by  <  name  >  . 
Retrying  lock,  press  Esc  to  cancel.  dBASE  IV  tries  to  lock  the  record 
repeatedly.  If  you  press  Esc,  dBASE  IV  stops  trying  to  lock  the  record. 

If  the  lock  is  successful,  the  system  determines  if  any  of  the  fields  have 
changed  since  you  accessed  the  record.  If  any  have,  the  system  updates  your 
screen  to  show  the  changes  and  allows  you  to  abandon  or  continue  your 
update. 

Alternatively,  the  system  may  display  the  error  message  Record  is  in  use  by 
another.  Retrying!  If  you  select  RETRY,  dBASE  IV  tries  to  lock  the  record 
again.  If  the  lock  still  is  not  granted,  the  error  message  reappears.  Try  to 
update  the  record  later.  If  you  select  ABORT,  dBASE  IV  cancels  your 
request  to  update  the  record.  Select  HELP  to  obtain  additional  information. 
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Using  dBASE  Commands 

Table  1-1  lists  dBASE  commands  that  can  be  entered  at  the  dot  prompt  by 
the  network  user  in  a  LAN  environment.  These  commands,  summarized 
here,  are  described  in  detail  in  Chapter  4. 


Table  1-1  dBASE  utility  commands 


dBASE  Command 

Use 

DISPLAY/LIST  STATUS 

Displays  or  lists  the  status  of  file  locks,  and 
whether  the  files  are  opened  for  exclusive  use 

DISPLAY/LIST  USERS 

Displays  the  network-assigned  workstation  name 
of  dBASE  users  who  are  currently  using  dBASE  IV 
from  the  shared  directory 

SET  PRINTER 

Redirects  print  output  between  a  local  printer 
port  and  the  shared  network  printer 

DISPLAY  STATUS  and  LIST  STATUS 

These  commands  provide  information  about  the  current  dBASE  IV  session 
on  the  network.  DISPLAY  STATUS  and  LIST  STATUS  are  identical,  except  that 
LIST  STATUS  does  not  pause  periodically;  DISPLAY  STATUS  does. 

To  use  the  DISPLAY  STATUS  command,  enter  DISPLAY  STATUS  or  DISPLAY 
STATUS  TO  PRINT. 

To  use  the  LIST  STATUS  command,  enter  LIST  STATUS  or  LIST  STATUS  TO 
PRINT. 

If  TO  PRINT  is  not  specified,  the  display  or  listing  appears  on  the  work¬ 
station  screen.  If  TO  PRINT  is  specified,  the  STATUS  display  or  listing  is 
directed  to  the  currently  defined  printer  and  to  the  display.  The  currently 
defined  printer  is  either  a  shared  network  printer  or  a  local  printer  defined 
through  the  SET  PRINTER  command  (described  later  in  this  section). 

Here  is  a  sample  STATUS  display.  Notice  the  status  of  file  locks  listed  for 
each  open  database  file. 
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.  DISPLAY  STATUS 
Currently  Selected  Database: 

Select  area:  1,  Database  in  Use:  H:MYFILE.DBF  Alias:  MYFILE 
Memo  file:  H : MYFI LE . DBT 

Lock  list:  2,  4,  6,  8  locked 

j 

Select  area:  2,  Database  in  Use:  H:ACCTG.DBF  Alias:  ACCTG 
Memo  file:  H:A*CCTG.DBT 

Lock  list:  database  locked 


File  search  path: 

Default  disk  drive:  H: 
Print  destination:  PRN: 
Margin  =  0 

Refresh  count  =  0 

Reprocess  count  -  0 

Number  of  files  open  * 
Current  work  area:  $ 


ALTERNATE 

-  OFF 

AUTOSAVE 

-  OFF 

BELL 

-  ON 

CARRY 

-  OFF 

CATALOG 

-  OFF 

CENTURY 

-  OFF 

CONFIRM 

-  OFF 

CONSOLE 

-  ON 

DEBUG 

-  OFF 

DELETED 

-  OFF 

DELIMITERS  -  OFF 
DESIGN  -  ON 
DEVELOP  -  ON 
DEVICE  -  SCRN 
ECHO  -  OFF 
EMACRO  -  OFF 
ENCRYPTION  -  ON 
ESCAPE  -  ON 
EXACT  -  OFF 
EXCLUSIVE  -  OFF 


FIELDS 

-  OFF 

FIXED 

-  OFF 

HEADING 

-  ON 

HELP 

-  ON 

HISTORY 

-  ON 

INSTRUCT 

-  ON 

INTENSITY 

-  ON 

LOCK 

-  ON 

MENU 

-  ON 

NEAR 

-  OFF 

PRINT  -  OFF 
SAFETY  -  ON 
SCOREBOARD  -  ON 
SPACE  -  OFF 
SQL  -  OFF 
STATUS  -  OFF 
STEP  -  ON 
TALK  -  ON 
TITLE  -  OFF 
TRAP  -  OFF 


Programmable  function  keys: 

F2  -  assist; 

F3  -  list; 

F4  -  dir; 

F5  -  display  structure; 

F6  -  display  status; 

F7  -  display  memory; 

F8  -  display; 

F9  -  append; 

F10  -  edit; 

CTRL-F1 
CTRL-F2 
CTRL-F3 
CTRL-F4  - 

CTRL-F5  - 

CTRL-F6  - 

CTRL-F7 
CTRL-F8  - 

CTRL-F9  - 

CTRL-F10  - 

SHIFT-F1  - 

SHIFT-F2  - 

SHIFT-F3  - 

SHIFT-F4  - 

SHIFT-F5  - 

SHIFT-F6  - 
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DISPLAY  USERS  and  LIST  USERS 

These  commands  display  the  network-assigned  names  of  workstation  users 
currently  logged  in  to  dBASE  IV.  To  display  these  names,  enter  DISPLAY 
USERS  or  LIST  USERS.  Here  is  a  sample  USERS  display: 


.  DISPLAY  USERS 
Computer  name 


WKSTN1 

WKSTN4 

WKSTN3 

>WKSTN2 

WKSTN7 


The  character  >  marks  the  currently  logged  user. 


SET  PRINTER 

The  SET  PRINTER  command  sends  dBASE  IV  printer  output  to  a  network 
or  local  device.  Use  this  command  to  redirect  print  output  from  a  shared 
network  to  a  local  printing  device  and  vice  versa. 

To  send  output  to  a  network  printer  on  an  IBM  PC,  IBM  Token-Ring,  or 
Ungermann-Bass  network,  you  would  enter: 


.  SET  PRINTER  TO  \\<computer  name>\<printer  name>*xdes tinat i on> 


■  <  computer  name  >  is  the  network-defined  server  name.  If  you  have 
established  the  network  printer  with  the  NET  USE  command,  you  cannot 
use  this  command.  Since  <  computer  name  >  must  be  a  unique  identi¬ 
fier  for  the  server,  it  cannot  be  a  group  name. 

■  <  printer  name  >  is  the  network-defined  printer  name.  The  printer  must 
be  defined  as  the  network  printer  used  by  <  computer  name  >  . 

■  <  destination  >  identifies  the  installed  printer:  LPT1,  LPT2,  or  LPT3,  as 
appropriate.  LPT  must  be  specified. 

The  following  commands  spool  the  output  of  report  CENSUS  to  the  network 
printer  (parallel  printer  number  1)  attached  to  the  server  named 
ATLANTIC!: 


.  SET  PRINTER  TO  \  \ATLANTIC1  \PRINTER=LPT1 
.  REPORT  FORM  CENSUS  TO  PRINT 
.  SET  PRINTER  TO  LPT1 


To  send  the  report  to  the  network  printer  on  a  Novell  network,  use  the 
Novell  SPOOL  or  CAPTURE  command  prior  to  starting  dBASE: 

F  >  SPOOL  L  =  2  Tl  =  5 
F  >  DBASE 
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Spool  LPT2:  with  the  timeout  option  and  redirect  output  to  the  network 
printer: 

j  .  SET  PRINTER  TO  LPT2 


Note  that  printing  of  one  or  more  files  in  the  network  printer  spool  does  not 
begin  until  the  SET  PRINTER  command  is  issued.  You  must  include  a 
printer  or  device  name  to  reset  the  printer  to  the  default  (currently  defined 
network  printer)  or  to  another  destination. 

If  you  want  to  send  the  report  to  a  local  device  on  a  Novell  network,  and  you 
have  spooled  as  shown  above,  simply  redirect  the  output  to  the  local  printer 
port,  as  follows: 


.  SET  PRINTER  TO  LPT1 


The  SET  PRINTER  command  establishes  a  DOS  device  as  the  destination  for 
printer  output.  <  destination  >  can  be  the  parallel  line  printers  (LPT1  or 
PRN,  LPT2,  LPT3)  or  the  COM  devices  (COM1,  COM2).  Note  that  it  is  not 
necessary  to  re-enter  the  command  to  reset  the  local  device. 

Using  the  TI  option  with  the  Novell  SPOOL  or  CAPTURE  command  will 
close  the  spool  file  and  send  it  to  the  printer  automatically. 

To  send  the  report  to  the  network  printer  on  a  3Com  3  +  network,  enter: 

F  >  3P  LINK  LPT2:  =  <  printer  name  > 

<  printer  name  >  is  the  network-defined  printer  name.  The  printer  must  be 
defined  as  the  network  printer  used  by  <  computer  name  >  . 


NOTE 

If  your  workstation  has  more  than  one  parallel  port,  you  can  use  one 
to  access  the  network  printer  and  another  to  access  a  local  printer. 
With  this  method,  you  do  not  need  to  specify  the  RUN/!  command. 
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About  This  Chapter 


This  chapter  introduces  the  following  dBASE  IV  programming  tools  and  con¬ 
cepts  used  in  a  network  programming  environment: 

■  Data  protection  problems  that  can  occur  in  a  local  area  network  and  the 
automatic  file  and  record  locking  solutions  provided  by  dBASE  IV. 

■  The  two  ways  to  open  a  file,  exclusive  or  shared,  and  how  each  affects 
locking. 

■  Read-only  and  read/write  file  access  attributes. 

■  Explicit  locking  tools  that  are  supported  in  dBASE  IV.  These  include  the 
FLOCKQ,  RLOCKQ,  and  LOCKQ  functions  and  the  UNLOCK  command. 

■  Error  trapping  procedures  that  use  the  ON  ERROR  command  to  trap 
errors,  the  ERRORQ  and  MESSAGEQ  functions  to  return  error  values, 
and  the  RETRY  command  to  control  program  execution. 

■  The  refresh  capability,  which  automatically  updates  database  information 
to  show  changes  made  by  other  network  users. 

■  Typical  procedures  used  to  test  for  the  presence  of  a  network,  add  a 
record  to  a  database  file,  and  edit  a  record  already  in  a  database  file. 

■  Security  tools  —  the  ACCESSQ  function  and  the  LOGOUT  command. 

■  dBASE  IV  commands  used  in  local  area  network  (LAN)  environments, 
including  SET  and  USE  EXCLUSIVE. 

■  Moving  single-user  programs  to  a  multi-user  environment. 


This  chapter  also  serves  as  an  introduction  to  Chapter  4,  which  describes  the 
commands  and  functions  used  in  a  LAN  environment. 


Data  Protection 

LAN  systems  face  potential  problems  that  do  not  occur  in  a  single-user  sys¬ 
tem  because,  in  a  LAN  environment,  users  have  access  to  shared  data  and 
program  files. 
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One  potential  problem,  called  collision,  could  occur  if  more  than  one  user 
attempted  to  edit  or  add  data  to  a  database  at  the  same  time.  If  collision 
were  allowed  to  happen,  either  no  user  update  would  be  successful  and 
there  would  be  no  change  to  the  data,  or  only  one  user  would  be  successful, 
while  all  the  other  users  would  believe  that  they  had  gained  access  to  and 
changed  the  data.  In  a  worst-case  situation,  the  database  file  might  be  dam¬ 
aged  or  destroyed. 

Another  problem,  called  deadlock,  can  happen  when  two  users  contend  for 
each  other’s  already  locked  files  or  records.  For  example,  a  deadlock  occurs 
if  user  A  needs  to  lock  the  file  or  record  previously  locked  by  user  B,  and 
user  B  attempts  to  lock  the  file  or  record  already  locked  by  user  A.  Figure 
2-1  illustrates  a  deadlock  situation  in  which  two  users  attempt  to  cross¬ 
update  a  pair  of  records  in  the  same  file. 


Database  File 


Figure  2-1  Deadlock 

In  a  deadlock  situation,  a  standoff  occurs:  neither  user  can  access  all  the 
files  or  records  necessary  to  complete  a  serial  transaction,  and,  instead  of 
exiting,  each  user  repeatedly  attempts  to  reaccess  an  unavailable  file  or 
record.  The  transactions  of  both  users  enter  into  a  standoff,  each  waiting 
for  the  lock  held  by  the  other  to  be  released.  The  only  way  to  correct  the 
deadlock  is  for  one  of  the  users  to  recognize  the  situation  and  back  out 
of  it. 

A  deadlock  can  also  occur  if  two  users  contend  for  each  other’s  files.  This 
happens  when  multiple  users  are  serially  accessing  each  other's  files  and 
each  is  using  a  program  sequence  that  includes  the  following  commands: 

SET  EXCLUSIVE  ON 

SELECT 

USE 

In  dBASE  IV,  the  automatic  retry  facility  helps  users  to  recognize  when  they 
might  be  in  a  deadlock  situation  and  to  release  their  lock  attempts.  After 
the  number  of  retries  specified  in  the  SET  REPROCESS  TO  command  is 
exhausted,  the  system  displays  a  prompt  box  and  the  user  can  choose  to 
cancel  the  lock  attempt  and  end  a  possible  deadlock. 

Multi-user  dBASE  IV  uses  locking  as  a  concurrency  control  mechanism,  to 
ensure  that  concurrent  transactions  accessing  the  same  database  file  at  the 
same  time  do  not  interfere  with  each  other's  operation. 
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Three  problems  can  adversely  affect  concurrent  transactions  and  produce 
incorrect  results:  lost  update,  uncommitted  dependency,  and  inconsistent 
analysis. 

A  lost  update  occurs  if  two  users  access  and  update  the  same  record  at 
approximately  the  same  time.  Both  users  are  unaware  that  another  user  has 
accessed  the  record.  The  first  user  that  updates  the  record  loses  out  because 
the  second  user  changes  the  values  entered  by  the  first. 

An  uncommitted  dependency  occurs  if  a  user  is  allowed  to  update  a  record 
that  has  been  updated  by  a  transaction  but  has  not  been  committed.  If  a  roll¬ 
back  occurs  on  the  transaction,  the  user  updating  the  record  before  it  has 
been  committed  may  be  updating  inaccurate  data.  See  Chapter  3,  “Trans¬ 
action  Processing,”  for  a  description  of  transaction  processing  and  recovery. 

Inconsistent  analysis  occurs  if  the  first  user  calculates  (adds,  subtracts,  aver¬ 
ages,  and  so  on)  a  series  of  database  values  and  a  second  user  changes  any 
of  those  values  before  the  first  user  completes  the  calculation.  The  first 
user  ends  up  with  an  incorrect  calculation  because  of  the  second  user’s 
interference. 

Any  LAN  system  must  protect  against  attempts  at  simultaneous  data  access. 

It  must  allow  multiple  modifications  to  database  files  without  losing  data  or 
corrupting  indexes.  Locking  guarantees  a  user  that  other  users  will  not  inter¬ 
fere  with  the  database  file  or  record  being  updated.  dBASE  IV  provides  two 
ways  to  protect  data  against  simultaneous  access  attempts:  locking  of  shared 
files  and  locking  of  shared  records.  File  and  record  locking  are  automatic. 
Whether  locking  is  required  at  all  depends  on  the  file  open  mode ;  that  is, 
whether  the  file  is  opened  for  exclusive  or  shared  access. 


Opening  a  File 

A  file  is  opened  in  one  of  two  modes,  exclusive  or  shared. 

If  a  file  is  opened  in  exclusive  mode: 

■  Only  one  requesting  user  can  access  the  file  at  a  time 

■  There  is  no  need  to  lock  the  file  or  any  record  in  the  file 
If  a  file  is  opened  in  shared  mode: 

■  Multiple  users  on  the  network  can  access  the  file 

■  Files  and  records  should  be  locked  before  updating 

The  file  open  mode  is  established  and  maintained  from  dBASE  IV,  which 
presets  or  defaults  the  file  open  mode  every  time  a  file  is  opened.  The  user 
can  change  how  the  file  is  opened  with  the  SET  EXCLUSIVE  command. 


work  level.  ( See  the  appropriate  appendix  in  Network  Installation.) 


NOTE 

A  file  can’t  he  shared  unless  it  is  in  a  shared  directory  or  the  user  has 
rights  to  the  directory.  Shared  directories  are  established  at  the  net- 
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Default  File  Open  Modes 

Table  2-1  summarizes  by  command  how  dBASE  IV  presets  file  open  modes. 
dBASE  IV  defaults  to  exclusive  use  so  that  your  files  are  not  shared  with 
other  users.  In  a  LAN  environment,  files  are  shared  after  the  execution  of 
a  SET  EXCLUSIVE  OFF  command  in  the  Config.db  file.  Remember  that: 

■  If  you  use  the  SET  EXCLUSIVE  OFF  command  to  reset  the  default  file 
open  mode  to  shared,  all  files  opened  after  you  issue  the  command  will 
be  opened  for  shared  access.  Locking  will  be  a  concern,  unless  the  file 
mode  has  been  set  as  read-only  at  the  network  level. 

■  The  SET  EXCLUSIVE  OFF  command  does  not  affect  files  already  opened 
for  exclusive  use. 


Table  2-1  Default  file  open  modes 


Command 

File  Type 

How  Opened 

APPEND  FROM 

Database  (.dbf)* 

Shared 

COPY  STRUCTURE  TO  Database  (.dbf)* 

Exclusive 

COPY  TO 

Database  (.dbf)* 

Exclusive 

CREATE 

Database  (.dbf)* 

Exclusive 

CREATE  <  file  1  > 
FROM  <  file  2  > 

Database  (.dbf)* 
Database  (.dbf)* 

Exclusive  <  file  1  > 
Shared  <  file  2  > 

CREATE  LABEL 

Labels  (.lbl) 

Exclusive 

CREATE  QUERY 

Query  (.qry) 

Exclusive 

CREATE  REPORT 

Report  (.frm) 

Exclusive 

CREATE  VIEW 

View  (.vue) 

Exclusive 

DO  <  filename  > 

Command  (.prg) 

Shared 

INDEX  ON 

Index  (.ndx)* 
Index  (.mdx)* 

Exclusive 

Exclusive 

JOIN 

Database  (.dbf)* 

Exclusive 

LABEL  FORM 

Labels  (.lbl) 

Shared 

MODIFY  COMMAND 

<  filename  >  Command  (.prg) 

Exclusive 

MODIFY  COMMAND 

<  filename  >  Format  (.fmt) 

Exclusive 

MODIFY  COMMAND 

<  filename  >  Procedure  (.prg) 

Exclusive 

MODIFY  LABEL 

Labels  (.lbl) 

Exclusive 

MODIFY  QUERY 

Query  (.qry) 

Exclusive 

MODIFY  REPORT 

Report  (.frm) 

Exclusive 

MODIFY  VIEW 

View  (.vue) 

Shared 

(continued) 
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Table  2-1  Default  file  open  modes  ( continued) 


Command 

File  Type 

How  Opened 

REPORT  FORM 

Report  (.frm) 

Shared 

RESTORE 

Memory  (.mem) 

Shared 

SAVE 

Memory  (.mem) 

Exclusive 

SET  ALTERNATE  TO 

Alternate  (.txt) 

Exclusive 

SET  CATALOG  TO 

Catalog  (.cat) 

Shared 

SET  FILTER  TO  FILE 

Query  (.qry) 

Shared 

SET  FORMAT  TO 

Format  (.fmt) 

Shared 

SET  INDEX  TO 

Index  (.ndx)* 

Exclusive** 

SET  PROCEDURE  TO 

Procedure  (  prg) 

Shared 

SET  VIEW  TO 

View  (.vue) 

Shared 

SORT 

Database  (.dbf)* 

Exclusive 

TOTAL 

Database  (.dbf)* 

Exclusive 

UPDATE  FROM 

Database  (.dbf)* 

Shared 

USE 

Database  (.dbf)* 

Exclusive** 

USE  <  file  >  INDEX 

Index  (.ndx)* 
Memo  (.dbt)* 

Exclusive** 

Exclusive** 

*  The  default  open  mode  for  index  and  memo  files  is  always  the  same  as  the 
default  for  the  database  file  with  which  they  are  associated. 

**  The  default  is  exclusive  if  SET  EXCLUSIVE  is  ON. 


NOTE 

The  following  special  cases  should  be  noted: 

■  Files  accessed  by  the  Control  Center  and  the  CHANGE  and  EDIT 
commands  are  opened  as  shared  files  if  SET  EXCLUSIVE  is  OFF. 


m  The  commands  CONVERT,  INDEX  ON  <  key  expression  >  TAG 
<  tag  name  >  ,  where  <  tag  name  >  is  an  .mdx  file,  INSERT 
[BLANK],  MODIFY,  PACK,  REINDEX,  RESET,  and  ZAP  can  be  used 
only  if  the  file  has  been  opened  for  exclusive  use.  The  default  for 
SET  EXCLUSIVE  is  ON.  If  you  attempt  to  use  one  of  these  commands 
and  the  file  is  not  opened  for  exclusive  use,  an  error  message  appears. 
You  will  need  to  close  the  file  and  reopen  it  for  exclusive  use. 

m  The  CREATE  and  SAVE  commands  automatically  set  a  file  for 
exclusive  use. 
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Default  File  Open  Attribute  Rules 

The  default  opening  mode  for  a  file  consists  of  a  combination  of  the  file 
open  mode  (exclusive  or  shared)  and  the  file  access  attribute  (read-only 
or  read/write).  The  “Using  dBASE  Files”  section,  later  in  this  chapter,  dis¬ 
cusses  the  file  access  attribute  and  the  full  default  opening  mode. 

Once  you  open  a  file,  some  commands  will  check  the  lock  status  of  the  file 
and  may  automatically  lock  that  resource  for  the  course  of  the  operation. 
These  commands  are  identified  later  in  this  chapter  in  the  “Automatic  File 
Locking”  section.  Other  dBASE  commands  may  require  that  the  file  be 
opened  for  exclusive  use.  These  commands  are  identified  above  in  the 
“Opening  a  File”  section. 

SET  EXCLUSIVE  OFF  Command 

If  you  plan  to  access  application  files  simultaneously  from  more  than  one 
workstation,  those  files  must  be  opened  for  shared  use.  If  your  application 
shares  files,  note  that: 

■  The  default  for  the  multi-user  SET  EXCLUSIVE  command  is  OFF,  which 
lets  you  share  the  files 

■  Files  opened  after  your  issuing  the  SET  EXCLUSIVE  ON  command  are 
not  shared  on  the  network 

Refer  to  Chapter  4  for  more  information  on  the  SET  EXCLUSIVE  command. 


Locking  Features 

dBASE  IV  automatically  attempts  to  lock  a  file  or  record  when  you  execute 
any  command  that  modifies  a  file  or  record.  If  you  are  using  a  CHANGE  or 
EDIT  command,  dBASE  IV  attempts  a  lock  when  you  enter  information  that 
updates  a  record;  that  is,  when  you  press  any  key  that  changes  the  record. 
Automatic  locking  ensures  that  each  file  or  record  you  change  is  guarded 
from  change  by  other  network  users  while  you  are  making  your  update. 

Automatic  file  and  record  locking  do  not  require  you  to  explicitly  lock  or 
unlock  the  file  or  record  you  are  updating.  You  do  not  need  an  FLOCK()  or 
RLOCKQ  function  to  create  a  lock,  and  you  do  not  need  an  UNLOCK  com¬ 
mand  to  release  a  lock.  The  "Automatic  File  Locking”  section,  below,  lists 
the  commands  that  automatically  lock  a  file  before  the  command  is  exe¬ 
cuted.  The  "Automatic  Record  Locking”  section,  below,  lists  the  commands 
that  automatically  lock  a  record. 

If  the  file  or  record  you  want  to  update  is  already  locked  by  another  network 
user,  the  system  displays  a  prompt  box  and  you  can  retry  or  abort  the  lock 
attempt.  The  LKSYS()  function  allows  you  to  determine  what  network  user 
has  locked  a  file  or  record,  plus  the  date  and  time  it  was  locked. 

Automatic  file  and  record  locking  make  it  easy  to  move  single-user  applica¬ 
tions  to  a  multi-user  environment.  When  you  do  this,  it  is  not  necessary  to 
program  a  lock  before  each  command  that  updates  a  file  or  record  and  an 
unlock  after  each  update. 
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While  you  may  want  to  manually  lock  a  file  or  record  to  explicitly  reserve 
it  in  some  situations,  you  should  treat  manual  locking  in  dBASE  IV  as  an 
exception  you  will  use  rarely,  if  at  all.  Manual  locking  is  necessary,  however, 
if  you  plan  to  run  your  application  under  dBASE  III  PLUS™. 

The  following  locking  discussion  is  for  programmers  whose  applications  use 
shared  files. 


dBASE  IV  Locking  Levels 

Locking  happens  at  four  levels: 

1 .  Automatic  file  locking.  At  this  level,  users  running  dBASE  IV  on  a  net¬ 
work  are  unaware  of  the  file  locking  features  that  dBASE  IV  automati¬ 
cally  provides. 

2.  Automatic  record  locking.  At  this  level,  users  running  dBASE  IV  on  a 
network  are  unaware  of  the  record  locking  features  that  dBASE  IV  auto¬ 
matically  provides. 

3.  Explicit  file  locking.  By  using  file  locking  commands  and  functions, 
users  can  claim  and  relinquish  specified  files. 

4.  Explicit  record  locking.  At  this  level,  a  user  locks  a  record  in  a  file, 
thereby  preventing  others  from  accessing  that  record  only. 

Each  locking  level  is  more  powerful  and  flexible  than  its  predecessor,  and 

requires  more  understanding  about  data  sharing. 


NOTE 

m  If  a  shared  file  is  opened  only  for  reading,  it  need  not  be  locked. 
There  is  no  danger  of  problems  arising  from  multiple  access  to 
shared  data,  unless  there  is  an  update  attempt. 


■  The  system  automatically  locks  related  files.  The  user  need  not  con¬ 
sider  locking  index  files  or  other  related  dBASE  files. 

m  The  system  automatically  locks  related  records. 


■  Locks  permit  any  user  to  read  the  locked  file  or  record,  even  if  it  is 
being  updated. 


Automatic  File  Locking 

When  a  file  is  not  being  used  exclusively  or  is  not  locked,  dBASE  IV  locks 
the  file  in  use  automatically  before  the  following  commands  are  executed: 


APPEND  FROM 
AVERAGE 
CALCULATE 
COPY 

COPY  STRUCTURE 
COUNT 


DELETE  <  scope  > 

INDEX 

JOIN 

LABEL 

PROTECT 

RECALL  <  scope  > 


REPLACE  <  scope  > 

REPORT 

SORT 

SUM 

TOTAL 

UPDATE 


If  the  file  can’t  be  locked,  a  prompt  box  appears.  You  can  then  retry  or  can¬ 
cel  the  lock  attempt.  If  an  automatic  file  lock  is  used,  dBASE  TV  automati¬ 
cally  unlocks  the  file  when  command  execution  is  completed. 
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NOTE 

Specifying  <  RECORD  #  >  as  the  scope  for  the  DELETE,  RECALL, 
and  REPLACE  commands  does  an  automatic  record  lock  instead  of 
a  file  lock. 


You  can  use  the  SET  LOCK  command  to  enable  or  disable  automatic  locking 
for  a  subset  of  the  commands  listed  above.  To  enable  automatic  locking  for 
the  following  commands,  you  must  issue  SET  LOCK  ON  before  you  use  any 
one  of  them. 

AVERAGE  INDEX  ON  <  key  expression  > 

CALCULATE  TO  <  .ndx  filename  > 

COPY  JOIN 

COPY  STRUCTURE  LABEL 
COUNT  REPORT 

The  above  commands  are  read-only  for  the  current  database  file. 


SORT 

SUM 

TOTAL 


WARNING 

These  commands  will  work  without  locking,  but  data  integrity  is  not 
guaranteed  if  automatic  locking  is  disabled.  If  you  use  SET  LOCK 
OFF,  there  will  be  greater  concurrency  and  a  greater  risk  of  possible 
inconsistent  analysis. 


Some  of  these  commands  have  two  phases,  reading  and  writing.  For  these 
commands,  SET  LOCK  works  only  on  the  reading  phase.  When  you  are  writ¬ 
ing  to  the  file,  it  is  automatically  opened  for  exclusive  use.  These  commands 
are: 

COPY  JOIN 

COPY  STRUCTURE  TOTAL 

INDEX  ON  <  key  >  TO  <  file.ndx  >  SORT 

Automatic  Record  Locking 

In  multi-user  dBASE  TV,  all  commands  that  update  a  record  lock  the  record 
automatically  before  making  the  update.  This  is  true  for  any  serial  database 
transaction  in  which  records  are  incrementally  updated  instead  of  fully 
changed.  If  the  records  in  a  file  are  to  be  fully  changed  rather  than  incre¬ 
mentally  updated,  record  locking  is  not  an  issue.  A  serial  database  transac¬ 
tion  is  one  where  the  following  sequence  of  events  occurs: 

1.  The  record  to  be  changed  must  be  locked  for  the  user  who  wishes  to 
change  the  data.  After  a  record  is  locked,  the  data  to  be  changed  must 
be  displayed.  This  step  ensures  that  the  user  sees  the  most  current  data 
at  the  time  it  is  locked.  At  that  point,  no  other  user  may  modify  the  data. 

2.  The  modification  is  made. 

3.  The  modified  record  is  saved,  and  then  is  unlocked. 


2-8 


dBASE  NETWORK  PROGRAMMING  CONCEPTS 


manhat  UKt*:  mannat  Juts:  manner  uiv:  ncnap^ 


When  a  file  is  being  shared,  dBASE  IV  automatically  attempts  to  lock  the 
record  before  the  following  commands  are  executed: 

APPEND  [BLANK]  RECALL 

DELETE  REPLACE 

dBASE  IV  attempts  to  lock  a  record  automatically  when  you  press  any  key 
that  modifies  the  record,  that  is,  any  key  that  changes  the  record.  If  the 
record  is  already  locked  by  another  user,  the  automatic  retry  facility  auto¬ 
matically  attempts  to  lock  the  record  the  number  of  times  you  specified  in 
a  SET  REPROCESS  command.  If  the  system  exhausts  all  its  attempts  to  lock 
the  record,  it  displays  a  prompt  box,  which  allows  you  to  continue  your 
attempt  to  lock  the  record' or  cancel  your  request.  If  you  press  any  naviga¬ 
tion  key  that  moves  to  another  record,  the  locked  record  is  automatically 
unlocked. 

You  may  still  want  to  use  explicit  record  locking  to  solve  lost  update  or 
uncommitted  dependency  problems. 


Explicit  File  Locking 

If  you  use  explicit  file  locking,  you  must  lock  the  file  before  using  a  com¬ 
mand  that  works  on  an  entire  file.  dBASE  IV  supports  explicit  file  locking 
with  the  FLOCKQ  function  for  compatibility  with  dBASE  III  PLUS.  Although 
explicit  file  locking  is  not  required  because  of  dBASE  IV’s  automatic  file 
locking  facility,  explicit  file  locking  can  be  used  when  shared  data  needs  to 
be  locked,  but  only  one  user  at  a  time  needs  to  update  the  data.  Explicit  file 
locking  requires  a  user  or  application  program  to  manually  lock  a  file  before 
it  is  updated,  and  then  manually  release  it.  Because  the  entire  file  is  locked, 
there  is  no  need  to  lock  records. 

Explicit  file  locking  can  be  useful  when  updates  can  affect  many  records  or 
index  files.  It  also  ensures  in  advance  that  a  required  set  of  files  is  available. 
If  you  use  the  FLOCKQ  function  to  explicitly  lock  a  file,  you  must  use  the 
UNLOCK  command  to  release  the  locked  file.  Other  users  can  still  read  a 
file  that  you  have  explicitly  locked. 


Explicit  Record  Locking 

For  compatibility  with  dBASE  III  PLUS,  you  can  still  use  LOCKQ  or 
RLOCKQ  to  explicitly  lock  a  record.  Another  user  can  read  a  locked  record, 
regardless  of  whether  it  has  been  automatically  locked  or  explicitly  locked. 
If  you  use  either  the  LOCKQ  or  RLOCKQ  function  to  lock  a  record,  you 
must  use  the  UNLOCK  command  to  release  the  locked  record. 


The  Explicit  Locking  Process 

In  dBASE  IV,  locking  prevents  collision.  A  locking  function  allows  dBASE  IV 
to  determine  whether  a  file  or  record  is  locked  by  another  user.  If  not 
locked,  the  function  returns  a  logical  true  (.T.)  value  and  places  a  lock  on 
the  file  or  record,  protecting  access  for  the  user  who  just  tested  the  status  of 
the  record. 
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You  can  implement  a  lock  through  a  locking  function:  FLOCKQ  for  files  and 
RLOCK()  (or  its  synonym,  the  LOCK()  function)  for  records.  These  locking 
functions: 

■  Test  for  a  lock 

■  Lock  an  unlocked  file  or  record 

■  Return  logical  values  that  result  from  their  test 


■  lock,  only  an  uniocKea  jue  or  recora. 

m  Operate  differently  than  most  functions  in  dBASE  IV,  because  lock¬ 
ing  functions  can  execute  an  action  ( locking )  as  well  as  return  a 
value  (.T.  or  .F.). 


NOTE 

The  locking  functions: 


Testing  for  a  Lock 

A  lock  function  checks  the  status  of  the  file  or  record  lock.  The  file  or  record 
is  either  available  (not  yet  locked),  or  not  available  (already  locked).  If  the 
file  or  record  is  not  locked  when  the  function  tests  its  lock  status,  the  lock 
is  placed,  preventing  update  to  the  file  or  record  by  other  users.  If  the  file 
or  record  is  locked  when  a  lock  request  arrives,  the  locking  function  can¬ 
not  be  executed,  and  the  locking  request  must  be  made  again  later.  See  the 
“Locked  Files”  and  “Locked  Records”  sections  in  Chapter  1. 

Locking  a  File  or  Record 

At  the  instant  a  lock  function  determines  that  a  file  or  record  is  not  locked, 
the  user  or  application  program  gains  control  of  the  file  or  record.  The  lock 
placed  on  the  file  or  record  informs  subsequent  lock  requests  that  the  file  or 
record  is  not  available  until  the  current  user  is  finished  with  it. 

The  record  lock  affects  one  or  more  records  and  their  associated  records. 

All  other  records  in  a  file  are  available  to  other  users. 

Returning  a  Logical  Value 

A  lock  function  returns  a  logical  value  of  true  (.T.)  or  false  (.F.).  It  returns 
true  when  the  file  or  record  being  tested  is  not  currently  locked  by  any 
other  user.  If  multiple  users  simultaneously  test  for  a  lock,  only  the  first 
test  received  gets  a  true  value.  A  lock  attempted  by  anyone  else  after  that 
will  test  false  and  has  no  effect  until  the  file  or  record  is  unlocked. 

Unlocking  an  Explicitly  Locked  File  or  Record 

Release  an  explicitly  locked  file  or  record  by  using  the  UNLOCK  command 
(described  in  Chapter  4),  by  locking  another  file  or  record,  or  by  closing  a 
database  file  with  a  CLOSE,  USE,  CLEAR  ALL,  or  QUIT  command.  Then,  the 
next  lock  function  on  the  file  or  record  will  test  true  and  the  lock  will  be 
placed  for  the  new  user,  who  will  gain  control  of  the  file  or  record. 
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Using  Explicit  Locking 

You  can  use  explicit  file  or  record  locking  interactively  or  implement  them 
within  an  application  program. 

Using  an  Explicit  Lock  Function  Interactively 

At  the  dot  prompt,  you  can  type  ?  FLOCK()  or  ?  RLOCK()  (or  alternatively, 
LOCK()),  followed  by  a  «-*.  dBASE  IV  responds  with  .T.  if  the  file  or  record 
is  locked  successfully.  The  file  or  record  is  now  locked.  If  another  user 
attempts  to  place  a  lock  on  the  file  or  record,  dBASE  IV  responds  with  .F., 
indicating  that  the  file  or  record  is  already  locked. 

Note  that  it  is  not  necessary  to  issue  a  locking  function  before  using  a  com¬ 
mand  that  automatically  locks  a  file  or  record.  See  the  “Automatic  File  Lock¬ 
ing”  and  "Automatic  Record  Locking”  sections  above. 

For  example,  if  you  want  to  replace  two  records  in  a  database,  you  might 
want  to  lock  the  records  before  issuing  the  REPLACE  command.  The  follow 
ing  example  uses  the  RLOCKQ  function  and  UNLOCK  command  to  show 
how  the  lock  can  be  implemented  interactively: 


.  USE  employee 

.  ?  RL0CKC5, 7",  "employee") 

.T. 

.  GOTO  5 

EMPLOYEE:  Record  No  5 
.  REPLACE  Name  UITH  "NELSON" 

1  record  replaced 
.  GOTO  7 

EMPLOYEE:  Record  No  7 
.  REPLACE  Name  UITH  "LAMBERT" 
1  record  replaced 
.  UNLOCK 


The  sample  application  included  on  the  Samples  disk,  and  described  at  the 
end  of  this  chapter,  includes  examples  of  using  the  REPLACE  command  with 
locks  in  a  program  file. 

When  in  full-screen  mode,  you  may  choose  to  lock  the  currently  viewed 
record  from  the  keyboard  by  simply  pressing  Ctrl-O.  Press  Ctrl-0  again  to 
unlock  the  record. 

For  the  full-screen  operation  on  shared  access  files,  the  record  lock  status 
is  displayed  in  the  network  section  (the  fourth  section)  of  the  status  bar  as 

Record  unlocked  or  Record  locked. 
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Explicit  Locking  in  Application  Programs 

An  expression  can  be  added  to  a  lock  function  to  qualify  or  expand  it.  This 
enhances  its  usefulness  to  dBASE  IV  network  programmers.  An  expression 
using  FLOCKO.  RLOCKQ,  or  LOCKQ  is  a  logical  expression  with  a  value  of 
either  true  (.T.)  or  false  (.F.).  For  example: 


DO  WHILE  .NOT.  RIOCKO 
00  TIMER 
IF  TIMES.UP 
?  CHR(7) 

DO  SH0W_MSG  WITH  "TIME-OUT  ON  WAITING  FOR  RECORD  TO  UNLOCK..." 

?  CHR(7l 
ON  KEY  LOOP 

00  SH0W_MSG  WITH  "PRESS  ESC  KEY  TO  EXIT  OR  SPACE  KEY  TO  CONTINUE  WAITING..." 
ENDIF 
ENDDO 


For  more  extensive  examples  of  file  and  record  locking,  refer  to  the 
discussions  of  the  FLOCK(),  LOCKQ,  and  RLOCKQ  functions  and  the 
UNLOCK  command  in  Chapter  4.  The  sample  network  application  pro¬ 
gram,  Employee. prg,  included  on  the  Samples  Disks  further  illustrates 
how  the  RLOCKQ  function  and  UNLOCK  command  can  be  used. 


Using  dBASE  Files 

How  dBASE  files  are  used  depends  on  the  full  opening  mode  for  a  file. 
The  full  opening  mode  for  a  file  consists  of  a  combination  of  the  file  open 
attribute  (exclusive  or  shared)  and  the  file  access  attribute  (read-only  or 
read/write). 


File  Access  Attributes 

The  file  access  attribute  is  the  permission  to  read  from  and  write  to  a  file.  It 
determines  what  a  user  can  do  with  the  file  once  it  is  opened.  The  file  access 
attribute  is  either  read-only  or  read/write. 

Read-only  means  that  the  user  can  view  the  contents  of  the  file,  but  can’t 
change  it. 

Read/ write  means  that  the  user  can  look  at  and  change  the  file.  The  file 
access  attribute  can  be  established  and  maintained  at  the  network  level. 

For  database  files,  file  access  attributes  can  also  be  assigned  through  the 
PROTECT  command  described  in  Chapter  5. 

File  Access  Attribute  Rules 

dBASE  IV  uses  the  following  rules  to  assign  the  default  file  access  attribute: 

1.  If  any  dBASE  file  is  being  created  or  modified,  it  is  opened  for 
read/ write  use. 

2.  If  a  command,  format,  label,  query,  report,  or  view  file  is  being  used 
only  to  get  information,  it  is  opened  for  read-only  use. 
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You  can  override  the  dBASE  default  by  using  the  DOS  command  ATTRIB  to 
set  the  file  access  attribute  to  read-only.  For  database  files,  use  the  PROTECT 
program  to  set  the  access  privilege. 


Errors  and  Error  Recovery 

How  errors  are  processed  in  dBASE  IV  depends  on  whether: 

■  The  user  is  at  the  dot  prompt 

■  A  full-screen  command  has  been  issued 

■  A  command  file  is  being  executed,  and  an  ON  ERROR  command  has 
been  issued 

At  the  dot  prompt,  error  processing  is  first  handled  by  the  automatic  retry 
facility.  This  facility  generates  the  program’s  error  condition  when  the  num¬ 
ber  of  retries  specified  in  the  SET  REPROCESS  TO  command  is  used  up  and 
the  user  selects  CANCEL. 

If  a  full-screen  command  has  been  issued,  error  processing  is  handled  auto¬ 
matically.  Error  messages  are  displayed  in  an  error  box. 

If  an  error  is  not  handled  automatically,  dBASE  IV  returns  an  error  state 
when  the  error  occurs.  If  the  error  state  is  not  captured  through  an  ON 
ERROR  procedure,  dBASE  IV  displays  the  error. 


ERROR()  and  MESSAGE() 

dBASE  IV  provides  two  functions  for  returning  error  values:  ERROR( ) 
and  MESSAGEQ.  The  ERRORQ  function  returns  the  number  of  an  error. 

The  MESSAGEQ  function  returns  the  error  message  text.  ERRORQ  and 
MESSAGEQ  are  used  within  an  error  processing  procedure.  ON  ERROR 
must  be  active  for  these  functions  to  receive  a  value.  In  a  LAN  environment, 
the  programmer  uses  the  ERRORQ  function  to  trap  recoverable  error  condi¬ 
tions,  such  as  attempts  to  lock  an  already  locked  file  or  record. 

Chapter  4  details  the  ERRORQ  and  MESSAGEQ  functions  and  includes 
examples  of  their  use. 


NOTE 

The  FLOCKf),  RLOCKf),  and  LOCK()  functions  do  not  return  an  error 
message  or  an  error  message  number.  These  functions  return  only  .T. 
or  .F. 


RETRY 


The  RETRY  command  restores  control  to  the  calling  program  or  procedure 
at  the  same  line  that  called  the  program.  RETRY  is  frequently  used  within  an 
ON  ERROR  procedure  to  re-execute  a  command  following  an  error.  RETRY 
differs  from  RETURN  because  RETRY  executes  the  same  line  in  the  calling 
program,  while  RETURN  executes  the  next  line. 
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Chapter  4  describes  the  RETRY  command  and  gives  examples. 

The  ERROR()  and  MESSAGE!)  functions  and  the  RETRY  command  are  only 
used  for  capturing  errors  when: 

■  A  command  file  is  being  executed 

■  An  ON  ERROR  command  fras  been  issued  to  trap  errors,  and 

■  The  error  message  will  not  be  displayed  on  the  screen 


Testing  For  a  Network 

You  can  use  the  NETWORK! )  function  to  test  for  the  presence  of  a  network. 
This  function  returns  a  logical  true  (.T.)  if  the  multi-user  version  of  dBASE  IV 
is  running,  or  a  logical  false  (.F.)  if  the  single-user  version  is  running.  The 
following  example  tests  for  the  presence  of  the  multi-user  version  of  dBASE  IV 
and  prompts  to  determine  if  the  user  wants  to  know  who  is  logged  in  to  the 
network: 


IF  NETWORK 0 

ACCEPT  "Do  you  want  to  see  who  else  is  logged  in?"  TO  answer 
IF  UPPER(answer)-"Y" 

DISPLAY  USER 
ENDIF 
ENDIF 


Adding  a  Record 

This  section  describes  one  way  to  write  an  application  program  that  allows 
users  to  add  a  record  to  a  database.  The  Library.prg  and  Employee. prg  pro¬ 
grams  in  Sample  Programming  Code  illustrate  these  steps  in  a  complete  appli¬ 
cation  program.  At  the  end  of  each  step  below,  you  are  referred  to  the  proce¬ 
dure  that  contains  the  commands  shown  in  that  step. 

1.  Display  a  main  option  menu  on  the  screen  that  allows  a  user  to  select 
l  the  needed  function: 


DEFINE  BAR  1  OF  mainjnnu  PROMPT  OPTION  MENU  — "  SKIP 
DEFINE  BAR  2  OF  mainjnnu  PROMPT  "  Add  record" 

DEFINE  BAR  3  OF  mainjnnu  PROMPT  "  Edit  record" 

DEFINE  BAR  4  OF  mainjnnu  PROMPT  "  Delete  record" 


The  user  can  press  the  first  letter  of  the  menu  choice  or  move  the  high¬ 
light  and  press  «->.  See  the  Bar_def  procedure  in  the  Library.prg  program. 
If  the  user  selects  the  Add  user  option,  the  Barpop  procedure  calls  the 
AdcLnew  procedure. 
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2.  Initialize  the  memory  variables: 

STORE  SPACE( 15)  TO  lastname 
STORE  SPACE ( 10 )  TO  firstname 

See  the  Init_fld  procedure,  which  is  called  by  Add_new. 

3.  Display  the  text  that  prompts  for  the  data  to  be  entered  by  the  user,  and 
specify  the  memory  variables  that  will  be  modified: 

0  5,  4  SAY  "LAST  NAME:"  GET  m->lastname  PICTURE  " ! XXXXXXXXXXXXXX" 

0  5,  33  SAY  "FIRST:"  GET  m->firstname  PICTURE  "IXXXXXXXXX" 

See  the  Screen  procedure  in  Employee. prg. 

4.  Wait  for  and  read  the  user  input: 

REAO 


See  the  Add_new  procedure  in  the  Librarv.prg  program. 

5.  Append  a  blank  record,  which  will  be  replaced  in  step  6  with  the  data  in 
memory: 


APPEND  BLANK 


The  APPEND  BLANK  command  uses  automatic  record  locking  to  ensure 
that  the  record  will  not  be  changed  by  any  other  network  user.  See  the 
Sav_data  procedure  in  the  Library.prg  program. 

6.  Replace  the  blank  record  with  the  data  in  memory: 


REPLACE  lastname  WITH  m->lastname,  ; 

firstname  WITH  m->firstname,  ; 


See  the  RepL_fld  procedure  in  Employee. prg.  The  REPLACE  command 
uses  automatic  record  locking  to  ensure  that  the  record  will  not  be 
changed  by  any  other  network  user.  The  record  stays  locked  only  for  the 
shortest  time  necessary,  and  is  automatically  unlocked  immediately  after 
it  is  replaced. 
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Editing  a  Record 

To  change  an  existing  record  in  a  database,  follow  the  same  sequence  as 
described  in  “Adding  a  Record.”  When  the  user  selects  Edit  record  from 
the  main  option  menu,  the  Barpop  procedure  calls  the  Edit  procedure  in 
Library. prg.  The  Edit  procedure  uses  the  CHANGE()  function  to  determine 
if  anyone  on  the  network  has  changed  the  record  since  the  user  first  acces¬ 
sed  it,  and  then  reads  the  user  input.  Step  5,  appending  a  blank  record,  is 
unnecessary. 


Updating  Viewed  Information 

If  you  are  using  the  BROWSE  or  EDIT  command  to  view  database  informa¬ 
tion,  other  users  on  your  network  may  be  entering  changes  to  the  database. 
The  SET  REFRESH  command  can  be  executed  before  using  the  BROWSE  or 
EDIT  command  to  ensure  that  changes  made  by  other  users  will  be  updated 
on  your  screen  at  specified  intervals.  See  the  SET  REFRESH  command  in 
Chapter  4  for  detailed  information. 


Security  at  the  Programming  Level 

Chapter  5  describes  the  file  and  field  access  security  features  available  to  the 
database  administratoi  through  the  PROTECT  command.  The  application 
programmer  can  use  the  ACCESS()  function  and  the  LOGOUT  command  to 
impose  security  from  an  application  program. 

The  ACCESS()  function  can  be  used  to  control  program  branching  based  on 
access  level.  The  description  of  the  ACCESS!)  function  in  Chapter  4  includes 
an  example  of  limiting  code  access  by  testing  the  user’s  access  level  returned 
by  the  ACCESS!)  function. 

The  LOGOUT  command  logs  out  the  current  user  and  implies  that  a  new  user 
is  to  be  logged  in.  For  security  purposes,  the  LOGOUT  command  clears  all 
memory  variables  in  the  history  buffer.  When  the  LOGOUT  command  is  pro¬ 
cessed,  the  workstation  screen  clears  and  a  log-in  screen  displays  in  which 
the  user  enters  the  log-in  name,  password,  and  group  name. 
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Other  dBASE  Networking  Commands 

Table  2-2  lists  and  describes  other  commands  of  particular  interest  in  a  LAN 
environment.  These  commands  are  detailed  in  Chapter  4. 


Table  2-2  Other  networking  commands 


Command  Description 

CONVERT  Permits  use  of  the  CHANGE( )  and  LKSYS( )  func¬ 

tions.  Also  allows  change  detection  with  automatic 
locking. 

DISPLAY/LIST  STATUS  In  a  network  environment,  displays  lock  status 
along  with  the  information  displayed  in  a  single- 
user  environment. 

DISPLAY/LIST  USERS  This  command  displays  the  network-assigned 

names  of  workstations  currently  logged  in  to 
dBASE  IV. 


SET 

SET  AUTOSAVE 
SET  ENCRYPTION 
SET  EXCLUSIVE 

SET  LOCK 
SET  PRINTER 
SET  REFRESH 
SET  REPROCESS 

USE  EXCLUSIVE 


In  a  network  environment,  AUTOSAVE, 
ENCRYPTION,  EXCLUSIVE,  LOCK,  REFRESH, 
and  REPROCESS  are  added  to  the  list  of  system 
parameters  that  can  be  displayed  and  set. 

This  command  automatically  updates  the  disk  file 
and  directories  after  I/O  operations. 

This  command  controls  whether  copied  files  are 
encrypted  when  created. 

This  command  determines  the  file  open  attribute 
of  all  database  files  USEd  (after  entering  the  com¬ 
mand)  during  the  dBASE  IV  session. 

This  command  enables  and  disables  automatic 
locking  for  a  subset  of  commands. 

This  command  redirects  printer  output  between 
shared  network  printers  and  local  printers. 

This  command  updates  viewed  database  informa¬ 
tion  if  changed  by  another. 

This  command  sets  the  number  of  times 
dBASE  IV  tries  a  network  command  or  function 
before  producing  an  error  message  or  a  logical 
result  for  a  function  in  case  of  network  conflicts. 

This  command  identifies  a  database  file  and  speci¬ 
fies  that  access  is  not  to  be  shared. 
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The  Sample  Application 

The  Samples  Disks  include  an  order  entry  application  program.  The 
Librarv.prg  program  in  that  application  illustrates  basic  network  pro¬ 
gramming  concepts.  This  program  includes  procedures  that: 

■  Define  a  pop-up  menu 

■  Add,  change,  and  delete  records 

■  Use  automatic  record  locking 

■  Time  out  after  waiting  for  a  record  to  unlock 

■  Demonstrate  use  of  the  RETRY  command 

Library.prg  contains  code  that  is  common  to  all  modules  in  the  order  entry 
application.  Networking  code  is  set  off  by  rows  of  asterisks.  The  entire  appli¬ 
cation  will  run  on  a  single-user  or  a  multi-user  system,  but  all  networking 
code  is  contained  in  one  core  module,  Library.prg.  The  other  modules  in  the 
application  do  not  require,  nor  do  they  contain,  any  network  commands. 

To  run  the  order  entry  application: 

1 .  The  files  from  the  Samples  Disks  must  reside  on  your  hard  disk  drive.  (If 
these  files  are  not  on  your  hard  disk,  request  the  Samples  Disks  from  your 
database  administrator  and  copy  them  to  this  directory  using  dBSETUP.) 

2.  Type  DBASE  and  press  «-■  while  in  the  \DBASE  directory,  to  access 
dBASE. 

3.  Enter  the  following  commands  at  the  dot  prompt: 

.  SET  PATH  TO  C:\DBASE\SAMPLES  «-• 

.  DO  BUSINESS 


See  the  Sample  Programming  Code  booklet  for  a  complete  listing  of 
Library.prg. 


Moving  a  Single-User  Program  to  a  Multi-User 
Environment 

Because  of  automatic  locking,  dBASE  IV  single-user  application  programs 
can  be  moved  to  a  multi-user  environment  with  a  minimum  of  programming 
effort.  Automatic  locking  places  a  lock  on  a  file  or  a  record  before  executing 
any  command  that  updates  a  database,  and  automatically  releases  the  lock 
after  the  update.  You  need  not  place  an  explicit  lock  (with  RLOCK(),  LOCK(), 
or  FLOCKO)  before  commands  that  update  a  database  file,  and  you  need  not 
execute  an  UNLOCK  command  after  an  update. 
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Before  you  run  a  single-user  application  program  on  a  multi-user  system, 

you  must  do  the  following: 

■  Enter  a  SET  EXCLUSIVE  OFF  command  to  make  subsequently  opened 
files  shareable  on  the  network.  This  command  is  required  in  a  multi-user 
program  because  the  default  file-opening  mode  opens  the  file  for  exclu¬ 
sive  use. 

■  Enter  multi-user  timing  mechanisms,  where  appropriate,  to  retry  a  lock 
on  a  file  or  record  a  specified  number  of  times.  See  the  SET 
REPROCESS  TO  command. 

■  Enter  a  SET  LOCK  OFF  command,  where  needed,  to  disable  automatic 
locking.  See  the  SET  LOCK  command. 

■  When  you  are  using  a  command  that  requires  EXCLUSIVE  to  be  set  on, 
you  must  SET  EXCLUSIVE  ON  before  using  the  file,  as  follows: 


SET  EXCLUSIVE  ON 
USE  <filename>  ZAP 
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Transaction 

Processing 


dBASE  IV  provides  a  transaction  processing  capability,  which  creates  a 
transaction  log  file  of  all  changes  to  database  files  and  ensures  that  you  can 
restore  database  files  interrupted  while  being  updated.  If  recovery  becomes 
necessary,  you  use  the  transaction  log  file  to  restore  the  values  in  your  data¬ 
base  files  to  those  that  existed  before  the  transaction  began. 

This  chapter  describes  how  to  do  the  following: 

■  Begin  and  end  a  transaction 

■  Recover  database  files  when  a  transaction  is  interrupted 

■  Retry  a  transaction 

■  Test  for  a  successfully  completed  recovery 

■  Determine  if  a  transaction  is  in  progress 

■  Test  for  a  successfully  completed  transaction 

■  Specify  USE  commands  in  a  transaction 

■  Use  the  transaction  log  file  to  its  fullest 

■  Recover  database  files  after  a  system  failure 

■  Use  locking  in  a  transaction 

■  Use  transaction  processing  at  the  dot  prompt 

Transaction  processing  is  meant  to  be  used  in  multi-user  dBASE  IV  to  solve 
system-interruption  problems  on  a  network.  The  transaction  processing  com¬ 
mands  and  functions  described  in  this  chapter,  however,  also  work  in  single- 
user  dBASE  IV. 


NOTE 

If  you  use  transaction  processing  on  a  network,  you  cannot  have  two 
users  logged  in  to  the  network  operating  system  with  the  same  name. 
The  first  eight  characters  of  any  network  log-in  name  must  be  unique. 
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Beginning  and  Ending  a  Transaction 

A  transaction  is  a  unit  of  work  which  contains  a  sequence  of  database  opera¬ 
tions.  These  operations  change  one  or  more  database  files.  Before  the  trans¬ 
action  begins  and  after  the  transaction  ends,  your  database  files  are  in  a 
consistent  state,  that  is,  all  intended  modifications  have  been  made.  If  the 
transaction  is  interrupted,  your  database  files  are  in  an  inconsistent  state, 
that  is,  only  some  of  the  intended  modifications  have  been  made. 

Once  you  start  a  transaction  with  the  BEGIN  TRANSACTION  command,  all 
data  commands  subsequently  executed  are  considered  part  of  the  transaction 
until  dBASE  IV  encounters  an  END  TRANSACTION  command.  Typically,  a 
transaction  contains  a  sequence  of  updates.  In  the  following  example,  all  sal¬ 
aries  are  replaced  with  a  higher  salary: 


BEGIN  TRANSACTION 

REPLACE  ALL  salary  WITH  salary  *1.1 
END  TRANSACTION 


If  the  above  series  is  interrupted  before  all  replaces  are  completed,  the  data¬ 
base  remains  in  an  inconsistent  state.  The  END  TRANSACTION  command 
signals  a  successful  completion  of  the  transaction  and  tells  the  system  that 
the  updates  can  be  made  permanent.  In  effect,  the  END  TRANSACTION 
command  commits  the  transaction. 

When  a  user  begins  a  transaction,  dBASE  IV  creates  a  transaction  log  file  for 
that  user  in  which  it  records  changes  to  database  files.  If  recovery  becomes 
necessary,  it  uses  this  file  to  accomplish  the  recovery.  When  dBASE  IV 
encounters  the  END  TRANSACTION  command,  it  purges  the  transaction  log 
file  (which  is  no  longer  needed).  It  also  releases  all  locks  at  the  end  of  a 
transaction. 


Recovering  Database  Files 

Transaction  processing  ensures  that  you  can  undo  an  interrupted  transaction. 
When  you  recover  or  rollback  a  transaction,  all  updates  (including  additions 
and  deletions)  are  reversed  and  all  database  files  are  left  in  their  original 
consistent  state,  as  if  the  transaction  was  never  executed.  A  rollback  is  neces¬ 
sary  if  any  interruption  occurs  while  a  transaction  is  in  process.  The  inter¬ 
ruption  might  be  a  power  failure,  the  inability  to  access  a  file  or  record,  or 
any  other  error  that  leaves  your  transaction  data  in  an  inconsistent  state. 

The  following  series  of  commands  tests  for  any  type  of  error  that  occurs  dur¬ 
ing  the  transaction  and  starts  a  recovery  if  an  error  occurs: 


ON  ERROR  ROLLBACK 
BEGIN  TRANSACTION 

REPLACE  ALL  salary  WITH  salary  *1.1 
END  TRANSACTION 
ON  ERROR 
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You  will  typically  use  ON  ERROR  to  transfer  control  to  a  separate  procedure 
that  informs  the  user  when  an  error  occurs  and  specifies  the  type  of  error. 
Here  is  an  example: 

1  SET  REPROCESS  TO  15 
ON  ERROR  00  err  proc 
BEGIN  TRANSACTION 

REPLACE  ALL  salary  WITH  salary  *  1.1 
END  TRANSACTION 
ON  ERROR 

PROCEDURE  err_proc 
DO  CASE 

CASE  ERROR!)  =  108  &&  File  is  in  use  by  another 

@  21,15  SAY  "Your  transaction  has  encountered  a  file  in  use  by  another." 
ROLLBACK 

CASE  ERROR!)  =  109  &&  Record  is  in  use  by  another 

@  21,15  SAY  "Your  transaction  has  encountered  a  record  in  use  by  another." 
ROLLBACK 
ENDCASE 
RETURN 

i - 1 

The  procedure  shown  above  uses  the  ERROR( )  function  to  test  for  two  spe¬ 
cific  types  of  errors.  A  rollback  occurs  only  if  one  of  the  errors  in  the  CASE 
statement  occurs. 


Retrying  a  Transaction 

A  user  may  want  to  retry  a  transaction  containing  a  command  that  has 
encountered  an  error  condition.  The  following  error  procedure  allows  the 
user  to  retry  a  transaction  or  abandon  the  transaction  and  start  a  recovery: 


PROCEDURE  err_proc 
choice  =  "  " 

@  21,15  SAY  "Your  transaction  has  encountered  an  error  condition." 
@22,15  SAY  "Do  you  wish  to  RETRY?  (Y/N)" 

GET  choice  PICTURE  "!" 

READ 

9  21,15  to  22,65  CLEAR 
IF  choice  =*  "Y" 

RETRY 

ELSE 

@  21,15  SAY  "Rolling  back  your  transaction  now.  Please  wait." 
ROLLBACK 
ENDIF 
RETURN 
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Testing  for  a  Successful  Recovery 

The  ROLLBACKS)  function  can  be  used  to  determine  whether  a  recovery 
was  successfully  completed.  The  following  error  procedure  informs  the  user 
when  an  error  condition  occurs,  a  rollback  starts,  a  rollback  ends,  and 
whether  a  rollback  is  successful  or  unsuccessful: 


I  PROCEDURE  err_proc 
|  choice  =  "  " 

1  @  21,15  SAY  "Your  transaction  h'as  encountered  an  error  condition." 

i  @  22,15  SAY  "Do  you  wish  to  RETRY?  (Y/N)" 

I  GET  choice  PICTURE  "!" 

READ 

@  21,15  to  22,65  CLEAR 
!  IF  choice  =  "Y" 

RETRY 

ELSE 

@  21,15  SAY  "Rolling  back  your  transaction  now.  Please  wait." 

ROLLBACK 

IF  ROLLBACK! ) 

@  21,15  SAY  "Rollback  completed  successfully." 

ELSE 

@  21,15  SAY  "Rollback  not  successful.  Restore  from  backup." 
ENDIF 
!  ENDIF 
i  RETURN 


Testing  for  a  Transaction  in  Progress 

The  ISMARKED( )  function  can  be  used  to  determine  whether  a  database  file 
is  having  transaction  updates  added  to  it  and  is  in  an  inconsistent  state: 


USE  customer 
IF  ISMARKEDO 

@  5,5  SAY  "The  file  you  need  has  an  active  transaction  on  it." 
@  6,5  SAY  "Please  try  again  later." 

RETURN 
I  ELSE 

REPLACE  ALL  salary  WITH  salary  +1.1 
ENDIF 
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Testing  for  a  Completed  Transaction 

The  COMPLETED! )  function  can  be  used  to  determine  whether  a  transaction 
was  successfully  completed.  Here  is  an  example: 


SET  REPROCESS  TO  15 
ON  ERROR  DO  err_proc 
BEGIN  TRANSACTION 

REPLACE  ALL  salary  WITH  salary  *  1.1 
END  TRANSACTION 
ON  ERROR 
IF  COMPLETED!) 

@  21,15  SAY  "Transaction  successfully  completed." 
ENDIF 


Specifying  USE  Commands  in  a  Transaction 

You  may  execute  a  USE  command  inside  or  outside  a  transaction.  If  you  exe¬ 
cute  multiple  USE  commands  inside  a  transaction,  you  must  have  assigned 
them  to  separate  work  areas,  as  shown  in  the  following  example: 


SET  REPROCESS  TO  15 
ON  ERROR  DO  err_proc 
BEGIN  TRANSACTION 

USE  clients  ORDER  lastname  &&  Assigned  to  work  area  1 

USE  inventry  IN  2  ORDER  part_no  &&  Assigned  to  work  area  2 

SEEK  mlastname 

REPLACE  orders  WITH  orders  +  1 
IF  SEEK(mpart_no,  "inventry") 

SELECT  2 

REPLACE  quantity  WITH  quantity  -  1 
ENDIF 

END  TRANSACTION 
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A  Complete  Example 

The  following  program  contains  the  commands  and  functions  introduced 
above.  Notice  the  use  of  the  COMPLETED! ),  ISMARKEDO,  and  ROLLBACK!) 
functions.  The  COMPLETED( )  function  tests  for  a  successfully  completed 
transaction.  The  ISMARKED( )  function  determines  if  a  transaction  is  in 
progress.  The  ROLLBACK!)  function  determines  whether  the  rollback  was 
successful.  The  program  displays  messages  to  keep  the  user  informed  of  sig¬ 
nificant  events. 

In  the  following  example,  the  SEEK  command  locates  an  account  number 
and  looks  into  a  field  in  the  accounts  file  to  see  if  this  account  has  specified 
that  it  is  time  to  order  again.  If  Yes,  a  new  invoice  is  added  to  the  invoices 
file.  The  program  then  goes  into  the  inventory  file,  and  looks  for  the  item 
code  as  specified  in  the  accounts  file  (SEEK  >  item_code).  In  the  inventory 
file,  the  example  decrements  the  quantity  on  hand  by  the  order  quantity 
specified  in  the  order  file.  If  the  quantity  on  hand  is  less  than  or  equal  to 
zero,  the  program  goes  to  the  vendor  file,  looks  for  the  vendor’s  number, 
and  flips  a  flag  that  says  it  is  time  to  order  more.  It  then  goes  to  the  invoices 
file,  and  replaces  the  amount  with  the  quantity  multiplied  by  the  price.  The 
program  then  goes  back  to  the  account  file  and  replaces  the  balance  with  the 
amount. 

This  program  uses  the  LKSYSQ  function.  All  databases  used  by  this 
program  must  be  converted  through  the  CONVERT  TO  24  command 
before  the  LKSYSQ  function  is  executed. 
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SET  REPROCESS  TO  15 
ON  ERROR  DO  err_proc 
DO  invoice 
ON  ERROR 
RETURN 

PROCEDURE  invoice 
BEGIN  TRANSACTION 

USE  accounts  ORDER  acctjio 

USE  invoices  IN  2  ORDER  inv_no 

USE  inventry  IN  3  ORDER  item_code 

USE  vendors  IN  4  ORDER  vend  no 

USE  shipaddr  IN  10  ORDER  accr_no  NOLOG 

SELECT  1 

Macct_no  *  acct_no 
SEEK  Macct_no 
IF  order_time  -  "Y" 


END  TRANSACTION 
RETURN 

PROCEDURE  err_proc 
choice  -  "  " 

DO  CASE 

CASE  ERROR! )  -  108 
otheruser  *  LKSYS(2) 

IF  LEN  (TRIM(otheruser))  -  0 
otheruser  -  "another" 

ENDIF 

@  21,15  SAY  "One  of  the  files  that  you  need  is  in  use  by  "  +  otheruser 
@  22,15  SAY  "Do  you  want  to  try  to  use  it  again?  (Y/N)"  GET  choice 
READ 

@21,15  CLEAR  TO  22,65 
IF  UPPER(choice)  -  "Y" 

RETURN 
DO  invoice 
ELSE 

IF  COMPLETED!) 

@  21,15  SAY  "The  file  in  use  by  another  is  not  part  of  a  transaction." 
@  22,15  SAY  "Returning  to  the  menu." 

RETURN  TO  MASTER 
ENDIF 

@  21,15  SAY  "Rolling  back  your  entries.  Please  wait..." 

ROLLBACK 

IF  .NOT.  ROLLBACK!) 

@  21,15  SAY  "The  rollback  was  not  successful.  You  must  restore" 

@  22,15  SAY  "from  backup  before  continuing." 

ENDIF 

ENDIF 

RETURN  TO  MASTER 

CASE  ERROR!)  -  109 
***  Similar  type  of  program 
ENOCASE 
RETURN 
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Transaction  Log  File 

A  recovery  operation  is  possible  because  the  system  maintains  a  transaction 
log  file  of  all  update  operations  that  occur  after  a  BEGIN  TRANSACTION 
command  and  before  an  END  TRANSACTION  command.  A  log  file  contains 
the  value  of  all  updated  items  before  the  updates  are  made.  The  system  uses 
a  transaction  log  file  to  restore  the  database  when  a  ROLLBACK  command  is 
executed.  A  log  file  contains  the  record  of  the  last  started  transaction.  A  log 
file  does  not  contain  the  updates  of  previous  transactions  because  it  is 
cleared  each  time  a  new  transaction  begins. 

The  transaction  log  file  is  named  Translog.log  on  a  single-user  system  and 
<  workstation  name  >  .log  on  a  multi-user  system.  The  workstation  name  is 
the  name  of  the  microcomputer  that  starts  the  BEGIN  TRANSACTION  com¬ 
mand  on  the  network.  On  a  Novell  network,  the  workstation  name  is  the 
login  ID;  on  all  other  networks,  it  is  one  of  the  computer  names  listed  when 
you  enter  a  DISPLAY  USERS  command. 

When  you  execute  a  ROLLBACK  command,  the  transaction  functions  as  a 
unit  of  recovery.  The  ROLLBACK  command  reverses  all  updates  in  the  trans¬ 
action,  including  updates  that  completed  accurately,  but  did  not  get  written 
before  the  system  failure. 

A  transaction  is  also  a  unit  of  concurrency,  because  the  transaction  log  file 
can  be  used  to  reverse  concurrent  transactions  that  interfere  with  each  oth¬ 
er's  operation. 


Recovering  Database  Files  After  a  System  Failure 

When  a  system  failure  occurs,  such  as  that  caused  by  a  power  loss,  the  net¬ 
work  administrator  is  normally  responsible  for  recovering  the  database  files 
for  all  users  that  had  transactions  in  progress  at  the  time  of  the  failure.  All 
incomplete  transactions  must  be  recovered  to  ensure  that  network  users  will 
be  able  to  access  the  database  files  used  by  the  incomplete  transactions. 

To  recover  the  database  files  for  all  incomplete  transactions,  follow  these 
steps: 

1 .  Log  in  to  the  network  as  the  network  administrator. 

2.  Examine  the  directories  to  determine  what  log  files  exist. 

3.  For  each  user  who  has  a  log  file,  log  in  to  the  network  as  that  user,  start 
dBASE  IV,  and  enter  the  ROLLBACK  command  at  the  dot  prompt. 

Be  sure  to  recover  the  database  file  for  all  users  who  have  a  log  file. 

Finding  a  log  file  can  be  simplified  if  all  log  files  are  stored  in  the  same 
directory.  The  <  path  name  >  parameter  of  the  BEGIN  TRANSACTION 
command  allows  you  to  specify  the  directory  where  the  log  file  will  be 
stored;  for  example: 


.  BEGIN  TRANSACTION  C:\L0GFILES 
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If  all  BEGIN  TRANSACTION  commands  specify  the  same  directory,  all  log 
files  will  be  stored  in  one  place. 


Locking  in  a  Transaction 

All  file  and  record  locks  created  in  a  transaction  remain  in  effect  until 
dBASE  IV  encounters  an  END  TRANSACTION  or  ROLLBACK  command. 

The  UNLOCK  command  has  no  effect  in  a  transaction.  Therefore,  a  transac¬ 
tion  should  not  cover  an  extended  length  of  time  because  all  locked  files  and 
records  will  not  be  accessible  to  other  users  until  the  transaction  has  ended. 


Transaction  Processing  at  the  Dot  Prompt 

Transaction  processing  commands  and  functions  can  be  entered  at  the  dot 
prompt;  however,  you  should  be  aware  of  the  following  considerations: 

■  Files  and  records  locked  during  a  transaction  remain  inaccessible 
for  updating  by  other  network  users  until  an  END  TRANSACTION  or 
ROLLBACK  command  is  executed. 

■  Error  processing  works  differently  at  the  dot  prompt  than  in  an  applica¬ 
tion  program. 


If  you  try  to  update  a  file  or  record  at  the  dot  prompt,  the  system  attempts  to 
lock  the  file  or  record.  If  the  lock  attempt  fails,  the  system  displays  a  prompt 
box  saying  the  file  or  record  is  in  use  and  allows  you  to  retry  or  cancel  the 
attempt.  If  you  choose  to  cancel  the  attempt,  the  system  displays  a  specific 
message  concerning  the  attempt. 
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Networking 
Commands 
and  Functions 


About  This  Chapter 

This  chapter  describes  the  syntax,  defaults,  and  behavior  of  each  dBASE 
command  and  function  used  in  programming  for  a  local  area  network  (LAN) 
environment. 

The  chapter  has  two  principal  sections:  "Using  Commands,”  and  "Using 
Functions.”  In  both  sections: 

■  Some  of  the  commands  and  functions  described  are  unique  to  net¬ 
work  programming,  and  some  are  used  in  single-user  and  network  pro¬ 
gramming.  If  a  command  or  function  is  used  in  programming  for  both 
single-user  and  LAN  environments,  basic  features  are  described  in  the 
Language  Reference  manual,  and  the  network  programming  function¬ 
ality  is  described  in  this  section. 

■  The  same  syntax  notations  described  in  the  Language  Reference  manual 
are  used. 


Examples  clarify  the  use  or  syntax  of  a  command  or  function.  When  appli¬ 
cable,  a  list  of  reference  commands  and  functions  that  affect  the  behavior 
of  a  command  or  function  is  given.  Where  appropriate,  a  reference  to  the 
Language  Reference  manual  is  included. 

Before  reading  this  chapter,  you  should  be  familiar  with  the  commands  and 
functions  as  described  in  the  Language  Reference  manual. 


Using  Commands 

Each  of  the  commands  described  in  this  section  falls  into  a  command  class. 
Table  4-1  lists  the  various  classes. 

Table  4-2  summarizes  the  commands  themselves.  The  table  lists  commands 
that  have  additional  syntax  or  enhanced  functionality  when  used  for  network 
programming. 
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Table  4-1  Command  classes 


Command  Class 

Database  Security 

Editing  of  Data 
Locking  Control 
Parameter  Control 
Programming 
User  Assistance 

Manipulating 

Databases 


Description 

Introduces  security  elements  at  the  programming 
level 

Allows  you  to  edit  the  data  within  a  database 
Ensures  data  integrity  in  network  applications 
Sets  a  dBASE  system  control  parameter 
Assists  in  the  control  and  usage  of  command  files 
Provides  on-line  information 
Specifies  how  .dbf  and  .ndx  files  are  opened 


Table  4-2  Summary  of  network  programming  commands 


Command 

Command  Class 

Intended 

Environment 

Description 

BEGIN 

TRANSACTION 

Editing  of  Data 

Single  user 
and  LAN 

Initializes  the  begin¬ 
ning  of  a  transaction 

CHANGE/EDIT 

Editii  ig  of  Data 

Single  user 
and  LAN 

Used  to  alter  the  con¬ 
tents  of  a  record  in 
the  active  database  file 

CONVERT 

User  Assistance 

LAN 

Permits  use  of  the 

SET  REFRESH  com¬ 
mand,  the  CHANGE() 
function,  and  the 
LKSYSQ  function 

DISPLAY/LIST 

STATUS 

User  Assistance 

Single  user 
and  LAN 

Provides  information 
about  the  current 
session 

DISPLAY/UST 

USERS 

User  Assistance 

LAN 

Provides  information 
about  the  currently 
logged  dBASE  users 

END 

TRANSACTION 

Editing  of  Data 

Single  user 
and  LAN 

Terminates  transac¬ 
tion  processing. 

Used  with  BEGIN 
TRANSACTION 

LOGOUT 

Database  Security 

Single  user 
and  LAN 

Forces  a  user  logout 
and  allows  a  new  user 
to  log  in 

(continued) 
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Table  4-2  Summary  of  network  programming  commands  (continued) 


Command 

Command  Class 

Intended 

Environment 

Description 

RESET 

Editing  of  Data 

Single  user 
and  LAN 

Changes  the  integrity 
tag  in  a  database  file 

RETRY 

Programming 

Single  user 
and  LAN 

Used  to  execute  a 
command  until  it 
can  be  completed 
successfully 

ROLLBACK 

Manipulating 

Databases 

Single  user 
and  LAN 

Used  with  transaction 
processing  to  undo 
changes  to  a  record  in 
a  database  file 

SET 

Parameter 

Control 

Single  user 
and  LAN 

Displays  and  changes 
the  current  values  of 
SET  values 

SET  AUTOSAVE 

Database 

Security 

Single  user 
and  LAN 

Automatically  updates 
the  disk  file  and  direc¬ 
tories  after  I/O 
operations 

SET 

ENCRYPTION 

Database 

Security 

LAN 

Establishes  whether 
encrypted  files  are 
encrypted  when 
copied 

SET 

EXCLUSIVE 

Parameter 

Control 

LAN 

Determines  the  file 
open  attribute  of  all 
database  files  subse¬ 
quently  opened  during 
the  session 

SET  LOCK 

Locking  Control 

LAN 

Enables  and  disables 
automatic  locking  for 
read-only  commands 

SET  PRINTER 

Parameter 

Control 

Single  user 
and  LAN 

Redirects  printer  out¬ 
put  to  a  network  or 
local  device 

SET  REFRESH 

Editing  of  Data 

LAN 

Updates  viewed  data¬ 
base  information  if 
changed  by  another 

user 


(continued) 
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Table  4-2  Summary  of  network  programming  commands  (continued) 


Command 

Command  Class 

Intended 

Environment 

Description 

SET 

REPROCESS 

Parameter 

Control 

LAN 

Sets  the  number  of 
times  dBASE  IV 
retries  a  network 
command  or  function 
before  producing  an 
error  message 

UNLOCK 

Locking  Control 

LAN 

Releases  record  and 
file  locks 

USE 

EXCLUSIVE 

Manipulating 

Databases 

LAN 

Opens  a  database  file 
and  related  files  in  the 
selected  work  area  for 
exclusive  use 

Before  reading  about  the  network  programming  commands  in  detail, 
you  should  first  be  aware  of  how  specific  commands  operate  in  a  LAN 
environment. 

dBASE  IV  system  management  governs  the  commands  that  update  the  data 
stored  in  a  database  and  associated  files.  Some  of  the  commands  require  that 
the  file  be  opened  for  exclusive  use.  Others  require  that  a  file  or  record  lock 
be  in  place.  In  the  latter  case,  the  system  tries  automatically  to  lock  the  file. 
This  process  is  not  visible  to  the  user,  unless  the  attempt  to  lock  the  file  fails, 
in  which  case  the  system  displays  an  error  message. 


Commands  Requiring  Exclusive  Use 

You  open  a  file  for  exclusive  use  through  the  SET  EXCLUSIVE  ON  command 
or  the  USE  <  filename  >  EXCLUSIVE  command  described  in  this  chapter. 
The  file  must  have  been  opened  for  exclusive  use  to  use  the  following 
commands: 


CONVERT  TO 

INDEX  ON  <  key  >  TAG  <  file.mdx  > 
INSERT  [BLANK] 

MODIFY  anything 
PACK 
REINDEX 
RESET  IN  ALUS 
ZAP 


If  a  file  has  not  been  opened  for  exclusive  use,  an  attempt  to  open  a  file 
through  one  of  these  commands  results  in  the  error  message  Exclusive  open 
of  file  is  required. 
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Files  Locked  and  Released  Automatically 

When  a  file  is  not  being  used  exclusively,  commands  that  work  on  an  entire 
file  first  attempt  to  lock  the  file  before  executing  the  command.  If  the  lock 
fails,  the  command  is  not  executed.  For  the  following  commands,  dBASE  IV 
attempts  to  lock  the  file  in  use  before  the  command  is  executed: 

APPEND  FROM 
DELETE  <  scope  > 

RECALL  <  scope  > 

REPLACE  <  scope  > 

UPDATE  <  scope  >  • 

When  command  execution  is  completed,  dBASE  IV  unlocks  the  file.  If  the 
file  can’t  be  locked,  dBASE  IV  displays  an  error  message. 


NOTE 

Specifying  NEXT  1  as  the  scope  for  the  DELETE,  RECALL,  and 
REPLACE  commands  performs  an  automatic  record  lock  instead 
of  a  file  lock. 
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BEGIN  TRANSACTION 


BEGIN  TRANSACTION  starts  recording  a  transaction.  It  can  be  used  in  a 
program  or  from  the  dot  prompt. 


Syntax 

BEGIN  TRANSACTION  [  <  path  name  >  ] 

Usage 

Use  this  command  to  start  a  transaction  that  updates  records  in  one  or  more 
database  files.  An  update  consists  of  any  of  the  following:  adding  a  new 
record,  changing  the  data  in  a  record,  or  changing  the  delete  status  of  a 
record. 

A  transaction  is  a  unit  of  work  that  uses  a  consistent  database,  executes  a 
series  of  updates,  and  produces  another  consistent  database.  While  the 
updates  are  being  made,  the  database  is  in  an  inconsistent  state.  If  any  fail¬ 
ure  occurs  during  the  updating,  the  transaction  can  be  reversed  to  the  con¬ 
sistent  state  that  existed  before  the  updates  started.  In  this  sense,  a  transac¬ 
tion  is  also  a  unit  of  recov  sry. 

The  BEGIN  TRANSACTION  command  creates  a  transaction  log  file  to 
track  the  beginning  status  of  the  database  file  and  the  changes  made  during 
the  transaction.  The  transaction  log  file  is  named  Translog.log  on  a  single- 
user  system,  and  <  Workstation  name  >  .log  on  a  multi-user  system.  The 
workstation  name  is  the  name  of  the  microcomputer  that  starts  the  BEGIN 
TRANSACTION  command  on  the  network.  On  a  Novell  network,  the  work¬ 
station  name  is  the  login  ID;  on  all  other  networks,  it  is  one  of  the  computer 
names  listed  when  you  enter  a  DISPLAY  USERS  command. 

The  transaction  log  file  works  with  the  ROLLBACK  command  to  reverse 
changes  that  leave  a  database  in  an  inconsistent  state.  Before  you  issue  an 
END  TRANSACTION  command,  you  can  reverse  the  changes  made  by  the 
transaction.  Use  the  ROLLBACK  command  to  restore  all  databases  to  their 
pre-transaction  state. 

If  the  change  is  satisfactory,  or  if  you  have  made  no  changes,  issue  an  END 
TRANSACTION  command.  The  END  TRANSACTION  command  deletes  the 
transaction  log  file  and  clears  the  integrity  tag  from  the  database  file. 

The  BEGIN  TRANSACTION  and  END  TRANSACTION  commands  must  be  in 
the  same  procedure. 
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BEGIN  TRANSACTION 


A  transaction  must  be  complete  and  the  log  file  deleted  before  you  can 
start  another  transaction;  transactions  cannot  be  nested.  To  perform  several 
transactions  in  succession,  bracket  each  transaction  between  a  BEGIN 
TRANSACTION  and  an  END  TRANSACTION  command,  as  follows: 


USE  Myfile 
BEGIN  TRANSACTION 

REPLACE  ALL  Salary  WITH  Salary  *1.1 
ENO  TRANSACTION 

LOCATE  FOR  Last_Name="Cuddigan" 

BEGIN  TRANSACTION 
EDIT  Salary 
END  TRANSACTION 


Nested  transactions,  as  shown  below,  are  not  permitted. 


USE  Myfile 
BEGIN  TRANSACTION 

REPLACE  ALL  Salary  WITH  Salary  *  1.1 
LOCATE  FOR  Last_Name-"Cuddigan" 

BEGIN  TRANSACTION 
EDIT  Salary 
END  TRANSACTION 
END  TRANSACTION 


NOTE 


dBASE  IV  commands  that  result  in  the  creation  of  a  new  file  are 
allowed  in  transactions,  but  commands  that  overwrite  an  existing  file 
are  not  allowed.  Overwriting  existing  files  makes  ROLLBACK  impossi¬ 
ble.  If  you  attempt  to  use  a  command  that  overwrites  a  file,  the  follow¬ 
ing  error  message  appears:  Cannot  execute  this  command  while 
transaction  is  in  process. 


dBASE  IV  commands  that  create  new  files  and  that  can  be  used  with  BEGIN 
TRANSACTION  are: 

AVERAGE 

COPY  [STRUCTURE]  TO  <  newfile  >  [EXTENDED] 

CREATE  <  newfile  >  [FROM  <  filename  >  ] 

EXPORT 

IMPORT  FROM  <  filename  > 

INDEX.. .TO  <  newfile  > 

JOIN.. .TO  <  newfile  > 

SET  CATALOG  TO  <  newfile  > 

SORT... TO  <  newfile  > 

TOTAL.. .TO  <  newfile  > 
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BEGIN  TRANSACTION 


Similarly,  dBASE  IV  commands  that  close  an  open  file  are  not  allowed  dur¬ 
ing  a  transaction.  These  commands  are: 


CREATE  [FROM] 
IMPORT 
INDEX  ON 
SET  CATALOG 
SET  INDEX 
USE 


In  addition,  the  following  dBASE  IV  commands  are  also  not  allowed  during 
a  transaction: 


CLEAR  ALL 

CLOSE  ALL/DATABASE/INDEX 

DELETE  FILE 

ERASE 

INSERT 

MODIFY  STRUCTURE 

PACK 

RENAME 

SET  CATALOG 

UNLOCK 

ZAP 


An  attempt  to  use  any  of  these  commands  during  a  transaction  results  in  an 
error  message.  The  UNLOCK  command  is  a  special  case.  It  does  not  produce 
an  error  message  and  has  no  effect  during  a  transaction. 


NOTE 

If  you  use  transaction  processing  on  a  network,  you  cannot  have  two 
users  logged  in  to  the  network  operating  system  with  the  same  name. 
The  first  eight  characters  of  any  network  log-in  name  must  be  unique. 


See  Also 

COMPLETED!),  END  TRANSACTION.  ISMARKED(),  RESET  IN  ALIAS, 
ROLLBACK,  ROLLBACK!),  SET  PATH 
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CHANGE/EDIT 


CHANGE/EDIT  are  full-screen  commands  used  to  alter  the  contents  of  a 
record  in  the  active  database  file.  CHANGE  and  EDIT  are  identical 
commands. 


Syntax 

CHANGE  [  <  scope  >  ]  [HELDS  <  field  list  >  ]  [FOR  <  condition  >  ] 
[WHILE  <  condition  >  ]  [NOFOLLOW]  [NOMENU]  [NOCLEAR] 

[  <  record  number  >  ][NOINIT]  [NOAPPEND]  [NOEDIT] 
[NODELETE] 


EDIT  [  <  scope  >  ]  [HELDS  <  field  list  >  ]  [FOR  <  condition  >  ] 

[WHILE  <  condition  >  ]  [NOFOLLOW]  [NOMENU]  [NOCLEAR] 

[  <  record  number  >  ][NOINIT]  [NOAPPEND]  [NOEDIT]  [NODELETE] 


Usage 

The  CHANGE  and  EDIT  commands  will  go  into  APPEND  mode  if  the  user 
attempts  to  move  the  cursor  past  the  last  record  in  the  file.  Also,  when  called 
from  BROWSE,  EDIT  will  respect  all  BROWSE  command  line  options  with 
the  exception  of  COMPRESS,  LOCK,  and  WINDOW. 

[NOFOLLOW] 

The  NOFOLLOW  option  has  an  effect  only  on  indexed  files.  If  NOFOLLOW  is 
used,  editing  a  key  field  value  repositions  the  record  according  to  its  new 
key  value  in  the  index,  but  the  record  that  took  its  original  place  in  the  index 
order  becomes  the  current  record. 

[NOMENU] 

The  NOMENU  option  prevents  access  to  the  menu  bar. 

[NOCLEAR] 

When  the  NOCLEAR  option  is  used,  the  record  will  remain  on  the  screen 
when  the  user  exits  EDIT.  Also,  the  memory  allocated  for  the  EDIT  table 
and  specifications  is  not  cleared.  This  means  that  the  screen  will  look 
exactly  as  it  did  when  you  last  exited  the  EDIT  command,  including  the 
cursor  position. 

[NOINIT] 

This  option  is  used  on  the  next  EDIT  command  to  call  up  the  previously 
defined  EDIT  without  generating  an  entirely  new  structure.  If  the  last  EDIT 
command  used  the  NOCLEAR  option,  then  this  command  will  use  the  screen 
specified  in  the  previous  EDIT  command. 
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CHANGE/EDIT 


[NOAPPEND] 

The  NOAPPEND  option  prevents  the  user  from  adding  records  to  the  current 
file  when  in  the  EDIT  mode. 

[NOEDIT] 

The  NOEDIT  option  puts  the  EDIT  table  in  a  read-only  condition  and  pre¬ 
vents  the  user  from  editing  any  records  when  in  the  EDIT  mode.  However, 
additions  can  be  made  to  database  files  and  records  can  be  marked  for  dele¬ 
tion  and  removed  permanently  from  the  file  with  PACK  and  ZAP. 

[NODELETE] 

The  NODELETE  option  prevents  the  user  from  deleting  records  (by  pressing 
Ctrl-U)  of  the  current  file  when  in  the  EDIT  mode. 

<  record  number  >  starts  the  edit  on  the  specified  record,  but  lets  you  move 
to  other  records  in  the  file.  You  may  also  use  the  keyword  RECORD,  which 
is  one  of  the  options  of  <  scope  >  .  If  you  use  the  scope  keyword  RECORD, 
however,  EDIT  is  limited  to  one  record,  and  does  not  allow  you  to  move  to 
other  records  in  the  file.  Because  EDIT  RECORD  <  record  number  >  limits 
the  edit  to  the  specified  record,  EDIT  RECORD  <  record  number  >  and 
EDIT  <  record  number  >  are  not  identical. 

In  a  LAN  environmer.t,  the  fourth  section  of  the  status  bar  displays  the  fol¬ 
lowing  file  or  record  information,  as  appropriate: 

Exclusive  use 
File  locked 
Read  only 
Record  locked 
Record  unlocked 

The  CHANGE  and  EDIT  commands  attempt  to  lock  the  record  and  all 
related  records  when  you  press  any  key  that  tries  to  update  that  record, 
that  is,  any  key  other  than  a  navigation  key.  If  the  lock  is  successful,  the 
system  determines  if  any  of  the  fields  have  changed  since  the  user  accessed 
the  record. 

If  any  information  has  changed  since  the  record  was  displayed  on  the  screen, 
the  screen  reflects  the  changes  and  the  system  displays  the  message  Data 
in  record  has  changed.  Press  Esc  to  abandon  and  any  other  key  to 
continue.  You  can  continue  or  abort.  If  you  press  Esc,  the  edit  attempt  is 
abandoned;  if  NOCLEAR  is  specified,  the  record  stays  on  the  screen  and  the 
record  is  unlocked.  Pressing  any  other  key  allows  you  to  continue  with  the 
edit  of  the  record.  Note  that  you  have  pressed  two  keys  at  this  point,  both  of 
which  count  as  part  of  the  edit. 

If  none  of  the  information  has  changed,  you  are  able  to  enter  information 
into  the  record. 
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CHANGE/EDIT 


Example 


.  USE  TEST 
.  EDIT  NOCLEAR 
♦  edit  record  Ctrl -W 
.  DISPLAY  STRUCTURE 
.  EDIT  NOINIT 
♦old  record  comes  back 

- f 
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CONVERT 


CONVERT  permits  subsequent  use  of  the  CHANGE()  and  LKSYS()  functions 
and  the  SET  REFRESH  command.  CONVERT  also  enables  automatic  change 
detection  for  BROWSE  and  EDIT  commands. 


Syntax 

CONVERT  [TO  <  expN  >  ] 

where  <  expN  >  is  the  length  of  the  field.  The  default  is  16,  and  the  field 
can  range  in  length  from  8  to  24  characters.  Using  MODIFY  STRUCTURE, 
you  can  alter  the  length  of  the  command  up  to  a  maximum  of  24  characters. 


Usage 

The  CONVERT  command  adds  a  field  to  the  structure  of  the  active  database 
file.  The  field  name  is  —DBASELOCK. 

If  you  specify  8  for  <  expN  >  ,  an  8-character  —DBASELOCK  field  is  added. 
You  can  then  use  the  SET  REFRESH  command  for  BROWSE  and  EDIT,  the 
CHANGEQ  function  to  see  if  a  record  has  been  changed,  and  the  LKSYSQ 
function  to  determine  the  date  and  time  a  record  was  locked.  If  you  specify 
16  for  <  expN  >  ,  you  can  do  all  of  the  above  and  also  use  the  LKSYSQ  func¬ 
tion  to  determine  the  first  8  characters  of  the  user  ID  that  locked  a  record.  If 
you  specify  24,  the  user  ID  returned  by  the  LKSYSQ  function  is  16  characters 
long. 

If  you  specify  8  for  <  expN  >  ,  the  system  does  not  save  the  user  ID,  date, 
and  time,  but  you  can  use  the  SET  REFRESH  command  and  the  CHANGEQ 
function.  Specifying  8  produces  a  smaller  file  and  prohibits  the  display  of 
user  IDs. 

When  you  enter  the  CONVERT  command,  the  current  database  file  is  copied 
to  a  .cvt  file  before  the  conversion,  and  a  new  .dbf  file  is  created. 

The  previous  SET  FIELDS  and  SET  RELATION  that  are  related  to  the  data¬ 
base  file  are  cancelled  when  you  use  the  CONVERT  command. 


Example 


.  USE  employee 
.  CONVERT 


See  Also 

CHANGEQ,  LKSYSQ,  MODIFY  STRUCTURE 
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DISPLAY/LIST 

STATUS 


DISPLAY  STATUS  and  LIST  STATUS  provide  information  about  the  current 
dBASE  IV  session. 


Syntax 

LIST  STATUS  [TO  PRINTER/TO  FILE  <  filename  >  ] 
DISPLAY  STATUS  [TO  PRINTER/TO  FILE  <  filename  >  ] 


Usage 


This  command  is  the  same  in  single-user  and  LAN  environments.  In  a  LAN 
environment,  however,  the  lock  status  for  each  open  database  file  and  a  list¬ 
ing  of  the  currently  locked  records  in  each  database  file  (if  any)  are  added  to 
the  single-user  information  displayed. 

The  single-user  information  displayed  is: 

■  Database  name 

■  Work  area  number 

■  Alias 

■  Database  relations 

■  Open  index  filenames 

■  Index  key  for  each  open  index  file 

■  Current  file  search  path 

■  Default  disk  drive 

■  Current  settings  for  most  ON/OFF  SET  commands  (in  a  LAN  environ¬ 
ment,  the  display  includes  settings  for  ENCRYPTION  and  EXCLUSIVE) 

■  The  setting  for  DEVICE  (SCREEN  or  PRINT) 

■  Left  margin  setting 

■  Function  key  and  programmable  key  assignments 

If  TO  PRINTER  is  specified,  the  STATUS  display  is  directed  to  the  currently 
defined  printer.  The  currently  defined  printer  is  either  the  selected  network 
printer,  or  a  local  printer  defined  through  the  SET  PRINTER  command  (des¬ 
cribed  later  in  this  chapter). 

If  TO  FILE  is  specified,  the  STATUS  display  is  directed  to  the  specified  file. 
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DISPLAY/LIST  STATUS 


Programming  Note 

LIST/DISPLAY  STATUS  can  be  useful  when  debugging  an  application  pro¬ 
gram;  for  example,  ON  ESCAPE  DISPLAY  STATUS. 


Example 

This  is  a  sample  STATUS  display  as  it  might  appear  in  a  LAN  environment 
(several  screens  have  been  combined  for  illustration  purposes): 


.  DISPLAY  STATUS 
Currently  Selected  Database: 

Select  area:  1,  Database  in  Use:  H : MYFI LE . DBF  Alias:  MYFILE 
Memo  file:  H:MYFILE.DBT 

Lock  list:  2,  4,  6,  8  locked 


Select  area:  2,  Database  in  Use:  H:ACCTG.DBF  Alias:  ACCTG 
Memo  file:  H: ACCTG. DBT 

Lock  list:  database  locked 


File  search  path: 

Default  disk  drive:  H: 
Print  destination:  PRN: 
Margin  -  0 

Refresh  count  =  0 

Reprocess  count  -  0 

Number  of  files  open  -  1 

Current  work  area:  $ 


ALTERNATE 

-  OFF 

DELIMITERS 

-  OFF 

FIELDS 

-  OFF 

PRINT 

-  OFF 

AUTOSAVE 

-  OFF 

DESIGN 

-  ON 

FIXED 

-  OFF 

SAFETY 

-  ON 

BELL 

-  ON 

DEVELOP 

-  ON 

HEADING 

-  ON 

SCOREBOARD 

-  ON 

CARRY 

-  OFF 

DEVICE 

-  SCRN 

HELP 

-  ON 

SPACE 

-  ON 

CATALOG 

-  OFF 

ECHO 

-  OFF 

HISTORY 

-  ON 

SQL 

-  OFF 

CENTURY 

-  OFF 

EMACRO 

-  OFF 

INSTRUCT 

-  ON 

STATUS 

-  OFF 

CONFIRM 

-  OFF 

ENCRYPTION 

-  ON 

INTENSITY 

-  ON 

STEP 

-  OFF 

CONSOLE 

-  ON 

ESCAPE 

-  ON 

LOCK 

-  ON 

TALK 

-  ON 

DEBUG 

-  OFF 

EXACT 

-  OFF 

MENU 

-  ON 

TITLE 

-  ON 

DELETED 

-  OFF 

EXCLUSIVE 

-  OFF 

NEAR 

-  OFF 

TRAP 

-  OFF 
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DISPLAY/LIST  STATUS 


Programmable  function  keys: 

F2 

-  assist; 

F3 

-  list; 

F4 

-  dir; 

F5 

-  display  structure; 

F6 

-  display  status; 

F7 

-  display  memory; 

F8 

-  display; 

F9 

-  append; 

F10 

-  edit; 

CTRL-F1 

- 

CTRL-F2 

- 

CTRL-F3 

- 

CTRL-F4 

- 

CTRL-F5 

- 

CTRL-F6 

- 

CTRL-F7 

- 

CTRL-F8 

- 

CTRL-F9 

- 

CTRL-F10 

- 

SHIFT-F1 

- 

SHIFT-F2 

- 

SHIFT-F3 

- 

SHIFT-F4 

- 

SHIFT-F5 

- 

SHIFT-F6 

- 
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DISPLAY/LIST  USERS 


DISPLAY/LIST  USERS  identifies  the  workstations  currently  logged  in  to 
dBASE  IV. 


Syntax 

DISPLAY  USERS 
LIST  USERS 


Usage 

DISPLAY/LIST  USERS  displays  the  network-assigned  computer  machine 
(workstation)  names  of  currently  logged  dBASE  network  users. 


WARNING 

This  command,  or  the  network  equivalent  of  it,  should  always  be 
issued  to  determine  whether  any  users  are  using  dBASE  IV  before 
dBASE  IV  is  uninstalled. 


Example 

The  following  is  a  sample  USERS  display: 


.  DISPLAY  USERS 
Computer  name 


WKSTN1 

WKSTN4 

WKSTN3 

>WKSTN2 

WKSTN7 


The  character  >  marks  the  currently  logged  user. 
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END  TRANSACTION 


END  TRANSACTION  terminates  a  transaction  to  change  a  record  in  a 
database  file. 


Syntax 

END  TRANSACTION 


Usage 

This  command  commits  the  active  transaction,  and  deletes  the  transaction 
log  file.  The  integrity  tag  placed  in  the  header  of  the  database  file  involved  in 
the  transaction  is  removed. 

You  should  not  use  this  command  until  you  are  certain  that  the  transaction 
has  done  what  you  wanted  it  to  do.  Once  you  issue  an  END  TRANSACTION 
command  and  the  transaction  log  file  is  erased,  the  only  way  to  restore  data¬ 
base  files  to  their  pre-transaction  state  is  to  restore  backup  files. 

The  BEGIN  TRANSACTION  and  END  TRANSACTION  commands  must  be  in 
the  same  procedure. 

You  must  use  this  command  to  terminate  a  transaction  before  starting 
another.  dBASE  IV  does  not  allow  transaction  nesting.  If  an  END 
TRANSACTION  command  is  not  executed,  the  transaction  log  file  is 
closed  when  the  program  exits. 

This  command  releases  all  locks  created  during  a  transaction. 


Example 

See  the  BEGIN  TRANSACTION  command. 

See  Also 

BEGIN  TRANSACTION,  COMPLETED*),  ISMARKED(),  RESET,  ROLLBACK, 
ROLLBACKO 
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LOGOUT 


LOGOUT  logs  out  the  current  user  and  allows  a  new  user  to  log  in. 


Syntax 

LOGOUT 

Usage 

This  command  enables  you  to  control  user  sign-in  and  sign-out  procedures. 
It  forces  a  logout  and  prompts  for  a  login. 

When  the  LOGOUT  command  is  processed,  the  workstation  screen  clears 
and  a  log-in  screen  appears  in  which  the  user  enters  a  group  name,  log-in 
name,  and  password.  The  PROTECT  command  establishes  log-in  verification 
functions  and  sets  the  user  access  level. 

LOGOUT  closes  all  open  database  files,  their  associated  files,  and  program 
files. 

You  can  also  use  this  command  if  you  need  to  log  in  to  a  different  group  to 
access  a  different  set  of  database  files. 


Special  Cases 

If  PROTECT  has  not  been  used,  no  Dbsystem.db  file  is  created  and  the 
LOGOUT  command  returns  to  the  dot  prompt. 


See  Also 

Chapter  5,  "dBASE  Security" 
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RESET 


RESET  resets  the  integrity  tag  in  a  database  file. 


Syntax 

RESET  [IN  <  alias  >  ] 

where  <  alias  >  is  an  alias  name  (which  may  be  the  same  as  its  filename),  a 
work  area  letter,  a  work  area  number,  or  an  indirect  reference. 


Usage 

The  integrity  tag  marks  files  that  have  a  transaction  in  progress.  This  tag  stays 
on  a  file  until  the  transaction  is  completed  or  a  successful  ROLLBACK  has 
occurred.  If  an  <  alias  >  is  not  specified,  the  current  database  file  is  reset. 

You  may  need  to  remove  this  tag  with  the  RESET  command  if  you  do  not  want 
to  ROLLBACK  a  database  file,  or  if  a  successful  ROLLBACK  is  not  possible. 

After  issuing  a  RESET  command,  you  can  access  the  file  for  another 
transaction. 

RESET  should  not  be  used  in  a  program.  Use  this  command  at  the  dot  prompt, 
when  necessary,  to  correct  an  unusual  situation. 

This  command  requires  exclusive  use  of  the  database  file. 


Example 


.  RESET  IN  U0RK3 

See  Also 

BEGIN  TRANSACTION,  END  TRANSACTION,  ISMARKEDO,  ROLLBACK, 
ROLLBACKO,  UNLOCK 
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RETRY 


RETRY  closes  the  program  or  procedure  file  in  which  the  command  was 
issued.  It  then  restores  control  to  the  program  or  procedure  that  called  it, 
at  the  same  line  that  called  the  program. 


Syntax 

RETRY 

Usage 

This  command  returns  to  the  program  that  called  the  present  program.  Then 
it  re-executes  the  line  that  called  the  program.  RETRY  is  normally  used  in  an 
ON  ERROR  procedure. 

The  RETRY  command  is  used  in  single-user  and  network  programming  to 
execute  a  dBASE  program  repeatedly  until  a  task  is  completed.  In  network 
programming,  you  use  the  RETRY  command  in  error  recovery  situations  to 
retry  execution  of  a  command  until  it  can  be  completed  successfully. 

Programming  Notes 

RETRY  differs  from  RETURN  in  that  RETRY  executes  the  same  line  in  the 
calling  program,  while  RETURN  executes  the  next  line. 


Examples 

See  the  example  in  the  description  of  the  ERRORQ  function  and  the  more 
extended  example  in  Chapter  2. 

See  Also 

ERRORQ,  MESSAGEQ,  SET  REPROCESSS 

The  section  "Errors  and  Error  Recovery”  in  Chapter  2 
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ROLLBACK 


ROLLBACK  restores  all  changes  made  to  records  in  a  database  file  since  a 
BEGIN  TRANSACTION  command  was  issued. 


Syntax 

ROLLBACK  [  <  database  filename  >  ] 


Usage 


This  command  restores  database  and  index  files  to  the  state  they  were  in 
before  the  current  transaction  began.  It  closes  and  deletes  all  database  and 
index  files  that  may  have  been  created  during  the  transaction. 

While  a  transaction  is  active,  you  can  use  ROLLBACK  only  on  the  database 
files  that  are  currently  active  in  the  transaction.  You  cannot  use  a  database 
filename  argument  while  a  transaction  is  active. 

ROLLBACK  compares  the  transaction  log  file  with  the  active  database  con¬ 
tents,  to  reverse  the  active  transaction  and  restore  the  database  file  to  the 
condition  it  was  in  at  the  beginning  of  the  transaction. 

Once  a  transaction  is  terminated,  you  can  use  the  ROLLBACK  command  only 
with  a  database  filename  argument.  In  this  case,  all  ROLLBACK  does  is  clear 
the  file  from  being  flagged  as  "in  use.”  You  will  have  to  restore  the  file  to  an 
unchanged  state  manually  from  backup  copies  or  hard  copy  records. 

A  transaction  log  file  contains  the  pre-  and  post-transaction  contents  of 
each  record  that  is  altered.  The  ROLLBACK  command  refers  to  the  trans¬ 
action  log  file  to  reverse  transactions.  ROLLBACK  can  fail  under  two 
circumstances: 


1 .  If  there  are  inconsistencies  between  a  record’s  pre-  and  post-transaction 
contents,  or 

2.  If  the  transaction  log  file  is  not  readable. 


At  the  end  of  a  successful  ROLLBACK  procedure,  the  database  file  is  restored 
to  its  pre-transaction  status.  The  transaction  log  file  is  reset  to  the  beginning 
and  remains  open  waiting  for  a  new  transaction. 

If  you  enter  a  SUSPEND  command  during  a  transaction,  the  transaction 
remains  active.  Commands  that  you  enter  during  the  suspended  mode  are 
considered  part  of  the  transaction,  and  it  is  acceptable  to  enter  a  ROLLBACK 
command  during  the  suspended  mode.  If  a  ROLLBACK  command  is  entered 
during  a  suspended  mode,  you  are  not  allowed  to  RESUME  the  suspended 
program,  because  it  would  restart  in  the  middle  of  a  transaction.  After  a 
ROLLBACK,  the  RESUME  command  executes  the  next  line  of  code  follow¬ 
ing  the  END  TRANSACTION  command. 
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ROLLBACK 


Examples 

To  restore  the  database  to  the  beginning  status  during  a  transaction  and 
verify  that  the  ROLLBACK  was  successful: 


.  ROLLBACK 

10  Records  checked 

After  a  failed  transaction,  to  do  a  manual  ROLLBACK  on  a  database  file: 

.  ROLLBACK  Name 

Also  see  the  example  in  BEGIN  TRANSACTION. 

See  Also 

BEGIN  TRANSACTION,  COMPLETEDQ,  END  TRANSACTION,  ISMARKEDQ, 
RESET,  ROLLBACKQ 
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SET 


SET  is  a  full-screen,  menu-driven  command  that  displays  SET  commands 
and  their  current  values.  It  also  allows  you  to  change  the  value  for  any 
setting. 

Syntax 

SET 


Usage 

This  command  allows  you  to  view  and  change: 

■  ON/OFF  SET  commands,  including  those  for  network  programming 

■  Screen  attributes 

■  Function  key  assignments 

■  Default  drive  and  search  path 

■  Alternate,  format,  and  index  files 

■  Left  margin 

■  Decimal  places 

In  a  LAN  environment,  ENCRYPTION  and  EXCLUSIVE  are  added  to  the  list 
of  SET  commands  that  can  be  set  ON/OFF. 


Examples 


The  Options  submenu  on  the  SET  menu  bar  that  appears  in  a  LAN  environ¬ 
ment  contains  the  following  settable  commands: 


ALTERNATE 

DELIMITERS 

HISTORY 

SAFETY 

AUTOSAVE 

DEVICE 

HOURS 

SCOREBOARD 

BELL 

DOHISTORY 

INSTRUCT 

SPACE 

CARRY 

ENCRYPTION 

INTENSITY 

STATUS 

CAIALOG 

ESCAPE 

LOCK 

TALK 

CENTURY 

EXACT 

MARGIN 

TITLE 

CONFIRM 

EXCLUSIVE 

MEMOWIDTH 

TRAP 

CURRENCY 

HELDS 

MENU 

UNIQUE 

DATE 

HXED 

NEAR 

DECIMALS 

HEADING 

PRECISION 

DELETED 

HELP 

PRINT 

If  you  select  Settings  from  the  Control  Center  Tools  menu,  a  subset  of  the 
above  option  list  appears. 
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SET  AUTOSAVE 


SET  AUTOSAVE  activates  or  deactivates  the  feature  that  updates  the  disk  file 
and  directories  after  you  update  a  single  record  or  a  group  of  records. 


Syntax 

SET  AUTOSAVE  on/OFF 

Defaults 

SET  AUTOSAVE  defaults  to  OFF. 

Usage 

The  SET  AUTOSAVE  ON  command  reduces  the  chance  of  data  loss  in  the 
event  of  a  power  loss  or  other  catastrophic  event.  However,  use  of  this  com¬ 
mand  slows  performance. 

If  AUTOSAVE  is  set  ON,  then  every  time  a  command  that  updates  records 
completes  its  operation,  the  directory  and  file  allocation  table  are  updated  to 
disk. 

Commands  that  update  groups  of  database  records,  such  as  REPLACE,  SORT, 
and  TOTAL,  perform  the  AUTOSAVE  operation  after  they  have  finished  pro¬ 
cessing  the  records.  Data  entry  commands  (APPEND,  INSERT)  and  editing 
commands  (BROWSE,  EDIT,  MODIFY  COMMAND/FILE)  perform  this  opera¬ 
tion  after  each  record  is  updated. 


Example 


SET  AUTOSAVE  ON 

1 

See  Also 


Chapter  6,  “Customizing  dBASE  IV,”  in  the  Language  Reference  manual 
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SET  ENCRYPTION 


SET  ENCRYPTION  establishes  whether  encrypted  files  are  encrypted  when 
copied. 


Syntax 

SET  ENCRYPTION  on/OFF 


Defaults 


SET  ENCRYPTION  is  normally  OFF. 


Usage 

The  SET  ENCRYPTION  command  determines  whether  copied  files  (that  is, 
files  created  through  the  COPY,  JOIN,  and  TOTAL  commands)  are  created  as 
encrypted  files.  The  command  avoids  the  overhead  involved  in  encrypting/ 
decrypting  files  when  it’s  not  necessary.  Note  that  the  original  file  must  be 
encrypted. 

Memo  (.dbt)  files  associated  with  the  database  file  are  encrypted. 

An  encrypted  file  contains  data  enciphered  into  another  form  to  hide  the 
contents  of  the  original  file.  An  encrypted  file  can  only  be  read  after  the 
encryption  has  been  deciphered  or  copied  to  another  file  in  decrypted  form. 

If  you  enter  a  valid  user  name,  password,  and  group  name  at  the  log-in 
screen,  dBASE  IV  will  open  an  encrypted  file. 

With  SET  ENCRYPTION  OFF,  a  file  can  be  copied  in  a  decrypted  form  (see 
the  “Examples”  section): 

■  The  authorization/access  levels  of  the  user  limit  the  information  that  will 
be  copied.  That  is,  a  copy  operation  will  be  limited  by  any  applicable  file 
and  field  access  level  controls,  and  by  field  access  privileges  as  well. 

■  The  COPY  TO  options,  EXPORT,  HELDS,  FOR,  WHILE,  TYPE 
DELIMITED,  WITH  BLANK,  DIF,  SDF,  SYLK,  and  WKS,  can  be 
specified  only  if  SET  ENCRYPTION  is  OFF. 

■  You  need  to  do  this  if  you  wish  to  EXPORT  the  file  or  use  it  with  single- 
user  dBASE  IV. 


NOTE 

Encryption  works  only  with  PROTECT.  If  you  do  not  enter  dBASE  TV 
through  the  log-in  screen,  you  will  not  be  able  to  use  encrypted  files. 
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SET  ENCRYPTION 


Tips 


All  encrypted  files  used  in  an  application  must  have  the  same  group  name. 

Encrypted  files  cannot  be  JOINed  with  unencrypted  files.  Make  both  files 
either  encrypted  or  unencrypted  before  JOINing  them. 

Encrypted  files  must  be  copied  to  files  in  decrypted  form  before  they  can  be 
used  with  the  COPY  STRUCTURE  EXTENDED  command.  (The  examples 
below  illustrate  how  to  create  a  decrypted  version  of  an  encrypted  file.)  After 
issuing  the  command,  you  can  encrypt  the  new  file  with  PROTECT  by  assign¬ 
ing  it  an  access  level. 

Files  created  through  the  CREATE  command  are  encrypted  through  the 
PROTECT  command  by  assigning  the  files  an  access  level. 


Examples 


You  cannot  use  the  MODIFY  STRUCTURE  command  (see  the  Language 
Reference  manual)  to  modify  encrypted  files.  Use  the  following  commands 
to  create  a  decrypted  version  first: 


USE  <filename  1> 
SET  ENCRYPTION  OFF 


&&  Identifies  an  encrypted 
&&  database  file  or  db  text  file 


COPY  TO  filename  2> 
USE  <filename  2> 


&&  Creates  a  decrypted 
&&  version  of  the  file 


MODIFY  STRUCTURE  filename  2> 
COPY  TO  <filename  1> 

CLOSE  ALL 

DELETE  filename  2> 

PROTECT 
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SET  ENCRYPTION 


The  following  example  sets  up  an  on-line  environment  in  which  a  user  is 
prompted  to  enter  the  name  of  an  encrypted  file  to  be  made  available  as  a 
decrypted  file  with  the  COPY  command.  The  example  assumes  the  user  has 
successfully  logged  in  through  PROTECT  and  belongs  to  a  group  that  can 
decipher  the  named  file. 


1  In_file-SPACE(8) 

00  WHILE  LEN(In_file»0 
ACCEPT  "Enter  filename  to  convert"  TO  In  file 
IF  LEN( In  file)«0 
EXIT 
ENOIF 

In_f i 1 e-TRIM( In_fi 1 e)+" . dbf " 

I  ACCEPT  "Enter  file  to  copy  to"  TO  Out  file 
IF  .NOT.  FILE("&In  file") 

LOOP 

ENDIF 

SET  ENCRYPTION  OFF 
USE  &In  file 
COPY  TO  &0ut  file 
|  ENDDO 

J - - - f 

See  Also 


Chapter  5  for  more  information  on  encryption 
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SET  EXCLUSIVE 


SET  EXCLUSIVE  determines  the  file  open  attribute  of  all  database  files  USEd 
(after  entering  the  command)  during  the  dBASE  IV  session. 


Syntax 

SET  EXCLUSIVE  on/OFF 

Defaults 

The  default  mode  for  dBASE  IV  is  SET  EXCLUSIVE  OFF.  By  system  default, 
all  opened  files  can  be  shared.  As  long  as  there  is  no  need  for  simultaneous 
access  by  multiple  users,  there  is  no  concern  about  locking  database  file 
resources. 


Usage 

When  set  to  ON,  all  files  opened  after  entering  the  command  are  for  the  sole 
use  of  the  network  user.  No  other  users  are  able  to  open  the  database  file. 
Until  the  user  closes  a  file,  no  other  network  user  has  any  access  to  the  file. 

When  set  to  OFF,  all  files  USEd  after  entering  the  command  are  opened  for 
shared  use.  If  the  file  is  to  be  accessed  simultaneously  by  multiple  users,  SET 
EXCLUSIVE  should  be  set  OFF. 


Tips 

If  you  open  a  .dbf  file  with  SET  EXCLUSIVE  OFF,  the  file  open  attribute  is 
shared  and  the  file  access  attribute  is  read/write.  If  you  wish  the  file  to  be 
read-only,  use  the  DOS  command  ATTRIB  to  set  the  read-only  flag  (on  a 
Novell  network,  use  the  FLAG  command). 

However,  if  you  open  a  .dbf  file  with  SET  EXCLUSIVE  ON,  the  file  open 
attribute  is  exclusive  and  the  file  access  attribute  is  read/ write.  Use  the  DOS 
command  ATTRIB  or  PROTECT  to  change  the  file  access  (on  a  Novell  net¬ 
work,  use  the  FLAG  command). 


Special  Cases 

In  a  single-user  environment,  SET  EXCLUSIVE  is  always  ON.  If  a  SET 
EXCLUSIVE  OFF  command  is  issued,  the  command  is  ignored. 
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SET  EXCLUSIVE 


Examples 

Assume  that  dBASE  IV  is  automatically  called  with  SET  EXCLUSIVE  ON. 

The  following  sequence  of  commands  opens  the  EVRY—ONE  database  files 
for  shared  use  and  the  MY—FILE  database  files  for  exclusive  use: 

1 


SET  EXCLUSIVE  OFF 

&&  Change  the  file  open 
&&  mode  to  shared. 

SELECT  1 

&&  Select  work  area  1,  and 

USE  Evry_one  INDEX  Evry_0ne 

&&  open  the  Evry_one 
&&  files  for  shared  use. 

SELECT  2 

&&  Select  work  area  2. 

SET  EXCLUSIVE  ON 

&&  Change  the  file  open 
&S  mode  to  exclusive. 

USE  My.file  INDEX  My_file 

&&  Place  the  My_file 
&&  files  in  work  area  2. 

I 


See  Also 

USE  EXCLUSIVE 

Chapter  2  for  a  discussion  of  the  file  open  and  file  access  attributes 
The  DOS  command  ATTRIB  (on  a  Novell  network,  the  FLAG  command) 
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SET  LOCK 


SET  LOCK  enables  and  disables  automatic  locking  for  the  following  com¬ 
mands:  AVERAGE,  SUM,  CALCULATE,  COPY  [STRUCTURE],  COUNT, 
INDEX,  JOIN,  REPORT,  LABEL,  TOTAL,  and  SORT. 


Syntax 

SET  LOCK  ON/off 


Defaults 


The  default  for  the  SET  LOCK  command  is  ON.  This  default  can  be  changed 
in  the  Config.db  file  by  using  the  command: 


i 

LOCK  -  OFF 

1 

Usage 


The  SET  LOCK  command  affects  only  a  subset  of  the  commands  that  are 
automatically  locked,  specifically  those  commands  that  do  not  modify  data 
values.  Although  these  commands  will  work  without  locking,  data  integrity 
is  not  guaranteed.  If  you  use  SET  LOCK  OFF,  there  will  be  greater  concur¬ 
rency,  but  also  a  greater  risk  of  possible  inconsistent  analysis. 

Some  of  the  commands  which  work  with  SET  LOCK  have  two  phases:  read¬ 
ing  and  writing.  SET  LOCK  affects  only  the  reading  phase.  When  writing,  the 
file  is  opened  for  exclusive  use  (for  example,  COPY  [STRUCTURE],  INDEX, 
JOIN,  TOTAL,  and  SORT). 
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SET  PRINTER 


SET  PRINTER  redirects  dBASE  IV  printer  output  to  a  network  or  local 
device.  You  use  this  command  to  redirect  print  output  to  a  local  printing 
device  or  a  shared  network  printer. 


Syntax 


Form  1:  Sending  Output  to  a  Network  Printer 

IBM  PC,  IBM  Token-Ring,  or  Ungermann-Bass  networks 

.  SET  PRINTER  TO  \\<computer  name>\<pr inter  name>~<des tinat i orv> 


Novell 

Use  the  Novell  SPOOL  or  CAPTURE  command  prior  to  starting  dBASE  IV: 

F  >  SPOOL  L  =  2  Tl  =  5 
F  >  DBASE 


Spool  LPT2:  with  the  timeout  option  and  redirect  to  the  network  printer: 


.  SET  PRINTER  TO  LPT2 

Form  2:  Sending  Output  to  a  Local  Device 

IBM  PC,  IBM  Token-Ring,  or  Ungermann-Bass  networks 

.  SET  PRINTER  TO  <destination> 

or 


Novell 

F  >  SPOOL  L  =  2  Tl  =  5 
F  >  DBASE 


- 1 

.  SET  PRINTER  TO  LPT1 

Form  3:  Emptying  the  Print  Spool  File;  Resetting  the  Default  Destination 

.  SET  PRINTER  TO  <printer  or  device  name> 

Defaults 

By  default,  output  is  spooled  to  the  printer  assigned  to  the  DOS  PRN  device. 
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SET  PRINTER 


Usage 

The  SET  PRINTER  command  changes  the  destination  of  printed  output. 

Form  1  of  the  command  spools  printer  output  to  a  network  printer. 

\\  <  computer  name  >  \  <  printer  name  >  is  used  to  identify  an  IBM  net¬ 
work  printer.  SPOOLER  is  used  to  identify  a  Novell  network  printer. 

<  computer  name  >  is  a  network-assigned  server  name.  It  must  be  a  unique 
identifier  for  the  server,  and  therefore  can’t  be  a  group  name. 

<  printer  name  >  is  a  network-assigned  printer  name.  Note  that 

<  computer  name  >  and  <  printer  name  >  are  assigned  via  the  network 
shell. 

<  destination  >  identifies  the  installed  printer:  LPT1,  LPT2,  or  LPT3,  as 
appropriate.  LPT  must  be  specified.  The  installed  printer  can  be  the  shared 
network  printer  defined  at  the  logged  user's  workstation,  or  it  can  be  a 
shared  printer  at  another  remote  workstation.  For  example: 

.  SET  PRINTER  TO  \SERVERPS0N-LPT1 

j 

Form  2  of  the  command  establishes  a  DOS  device  as  the  destination  for 
printer  output.  <  destination  >  can  be  the  parallel  line  printers  (LPT1 
or  PRN,  LPT2,  LPT3)  or  the  COM  devices  (COM1,  COM2).  SET  PRINTER 

TO  LPTx/COMx  initiates  spooled  output  to  the  assigned  DOS  device.  For 
example: 

.  SET  PRINTER  TO  LPT2 

i - 

Form  3  of  the  command  empties  the  print  spooling  file  and  resets  the  printer 
destination  to  its  default  (the  currently  defined  shared  network  printer)  or  to 
another  destination.  For  example: 

] 

1  i 

.  SET  PRINTER  TO  LPT2 

1 

-j 

Special  Cases 


If  the  local  printer  has  been  redirected,  use  Form  2  of  the  command  to  send 
printer  output  to  the  local  device. 
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SET  PRINTER 


Programming  Notes 

Printing  of  spooled  files  begins  only  when  the  SET  PRINTER  command  is 
issued  (see  the  Language  Reference  manual).  Many  files  can  be  collected 
for  printing  before  print  files  begin  to  print.  Once  printing  begins,  it  can  be 
cancelled  only  at  the  network  shell  level.  You  can  use  the  RUN  command  to 
return  to  the  network  shell  from  within  dBASE  IV,  but  only  if  your  computer 
is  configured  with  enough  memory. 


Examples 

The  following  commands  spool  the  output  of  report  CENSUS  to  the  network 
printer  (parallel  printer  number  1 )  attached  to  the  server  named  ASERVER: 


.  SET  PRINTER  TO  \\ASERVER\PRINTER~LPT1 
.  REPORT  FORM  CENSUS  TO  PRINT 
.  SET  PRINTER  TO  LPT1 


The  first  command  redirects  LPT1  to  the  network  printer;  the  second  com¬ 
mand  sends  the  output  to  the  spooler;  the  third  command  sends  the  output 
to  the  printer  and  resets  the  network  printer. 

The  following  commands  will  set  up  a  local  printer  as  the  printer  output  des¬ 
tination.  Note  that  you  must  disconnect  the  network  printer  via  the  RUN/! 
command  before  resetting  the  printer  device  to  the  local  printer.  For  exam¬ 
ple,  on  a  Novell  network: 


1 

.  RUN  ENDSP00L 

.  SET  PRINTER  TO  <destinatiorv> 

.  REPORT  FORM  CENSUS  TO  PRINT 

NOTE 

If  your  workstation  has  more  than  one  parallel  port,  you  can  use  one 
to  access  the  network  printer  and  another  to  access  a  local  printer. 
With  this  method,  you  do  not  need  to  specify  the  RUN/!  command. 
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SET  REFRESH 


SET  REFRESH  updates  the  display  of  the  database  in  BROWSE/EDIT  at  a 
specified  interval  to  show  changes  made  by  other  users. 


Syntax 

SET  REFRESH  TO  <expN> 

where  the  value  of  <  expN  >  is  from  1  to  3,600. 


Defaults 

The  default  is  0,  which  means  the  display  is  not  updated. 


Usage 

The  SET  REFRESH  command  only  works  in  BROWSE,  EDIT,  and  CHANGE. 

This  command  must  either  be  set  in  Config.db  using  REFRESH  *  ,  or  must 
be  executed  before  you  start  the  BROWSE/EDIT  session.  It  is  in  effect  for 
the  current  work  session  or  until  it  encounters  another  SET  REFRESH 
command. 

The  command  works  differently  in  BROWSE  than  in  EDIT.  In  BROWSE, 
when  the  refresh  count  reaches  zero,  dBASE  IV  checks  the  information 
on  all  records  in  the  network  that  are  currently  viewed  in  the  BROWSE 
table  and  replaces  the  old  screen  with  a  new  screen  containing  updated 
information. 


Examples 

The  following  example  allows  you  to  view  the  Employee  database  with  the 
knowledge  that  the  data  will  be  updated  and  shown  on  your  screen  every 
five  seconds,  if  anyone  changes  the  data: 


USE  employee 

CONVERT 

SET  REFRESH  5 


The  converted  file  now  has  a  .dbt  extension  and  is  already  in  use.  Alterna¬ 
tively,  you  can  use  the  SET  REFRESH  command  while  using  the  EDIT  com¬ 
mand  instead  of  BROWSE.  If  you  use  the  SET  REFRESH  command  in  EDIT, 
you  must  have  the  status  line  on. 


See  Also 

BROWSE,  CONVERT,  EDIT 
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SET  REPROCESS 


SET  REPROCESS  sets  the' number  of  times  dBASE  IV  retries  a  command  or 
function  that  causes  a  network  error  before  producing  an  error  message. 

Syntax 

SET  REPROCESS  TO  <  expN  > 


Usage 

Use  this  command  in  a  local  area  network  to  change  the  command  execu¬ 
tion  process.  A  record  or  a  file  may  be  in  use  on  the  network,  and  several 
retries  may  be  required  to  access  it. 

You  can  request  from  1  to  32,000  retries  with  <  expN  >  ,  or  you  can  specify 

—  1  to  continuously  retry  a  command  until  execution  occurs.  If  you  specify 

—  1  and  another  network  user  has  locked  a  file  or  record  you  need  to  access, 
the  system  will  appear  to  hang.  In  such  a  situation,  the  user  who  has  locked 
the  file  or  record  must  release  it. 

If  you  set  the  numeric  value  to  0,  with  no  ON  ERROR  command,  dBASE  IV 
displays  a  Please  Wait,  another  user  has  locked  this  record  or  file  while  it 
tries  an  infinite  number  of  times  to  lock  the  record  or  file.  You  can  use  the 
Esc  key  to  interrupt  the  program  from  retrying  endlessly  if  you  prefer. 

If  you  do  not  use  SET  REPROCESS,  the  system  does  not  display  the  name  of 
the  user.  The  system  says  that  the  file  or  record  is  in  use  by  another. 


Examples 

This  example  shows  that  after  the  first  20  tries,  the  record  was  not  success¬ 
fully  locked.  Selecting  the  Retry  option  from  the  box  resulted  in  a  successful 
lock,  and  the  function  returned  a  logical  true  (.T.): 


SET  REPROCESS  TO  20  &&  20  retries  will  be  made,  if  a  file  is  locked 

USE  EMPLOYEE 

*  for  a  simple  example  1: 

*  to  edit  record  32 
GO  32 

*  for  a  simple  example  2: 

*  update  records  for  a  particular  employee 

REPLACE  salary  WITH  salary  *  1.1  FOR  empl_num  =  "1001" 


See  Also 

RLOCK()/LOCK(),  UNLOCK.  USE,  USE  EXCLUSIVE 
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UNLOCK 


UNLOCK  releases  record  and  file  locks  so  that  other  users  can  access  the 
data. 


Syntax 

UNLOCK  [ALL/IN  <  alias  >] 

where  <  alias  >  is  an  alias  name  (which  may  be  the  same  as  its  filename),  a 
work  area  letter,  a  work  area  number,  or  an  indirect  reference. 


Usage 

Once  locked,  a  record  or  file  can’t  be  modified  by  another  user  until  the 
UNLOCK  command  has  been  executed  to  unlock  the  record  or  file. 

The  UNLOCK  command  unlocks  the  current  record  or  the  current  file  in 
the  selected  work  area.  UNLOCK  ALL  releases  all  current  locks  in  all  work 
areas.  The  current  lock  is  the  last  lock  function  issued  in  the  selected  work 
area. 

This  command  releases  the  last  record  lock  in  the  selected  work  area  if 
RLOCKQ  or  LOCKQ  is  the  last  lock  function  issued  in  the  selected  work 
area.  This  command  rel<  ases  the  last  file  lock  if  FLOCK( )  is  the  last  lock 
function  issued  in  the  selected  work  area. 

If  you  lock  a  record  or  file  while  it  is  actively  related  to  other  open  files, 
then  all  the  files  in  the  relation  are  automatically  locked.  Unlocking  the 
record  or  file  automatically  unlocks  all  the  related  files. 

If  you  specify  an  incorrect  <  alias  >  ,  the  error  message  Alias  not  found 
appears. 

The  UNLOCK  command  has  no  effect  if  a  transaction  is  in  process.  The  END 
TRANSACTION  command  releases  all  locks  created  during  the  transaction. 
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UNLOCK 


Examples 


The  following  example  illustrates  using  the  RLOCK()  function  to  lock  a 
record  and  the  UNLOCK  command  to  unlock  it.  (The  “Examples”  section 
for  the  FLOCKQ  function  includes  a  program  use  of  the  UNLOCK 
command.) 

- j 

.  USE  employee 
.  ?  RL0CKC5, 7",  "employee") 

.T. 

.  GOTO  5 

\  EMPLOYEE:  Record  No  5 

.  REPLACE  Name  UITH  "NELSON" 

1  record  replaced 
.  GOTO  7 

EMPLOYEE:  Record  No  7 
.  REPLACE  Name  UITH  "LAMBERT" 

1  record  replaced 
I  .  UNLOCK 


See  Also 


FLOCKQ,  RLOCKQ/LOCKQ 

The  section  “Using  an  Explicit  Lock  Function  Interactively”  in  Chapter  2 
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USE  EXCLUSIVE 


USE  EXCLUSIVE  opens  a  database  and  related  files  in  the  selected  work 
area  for  exclusive  use. 


Syntax 

USE  [  <  database  filename  >  ]  [INDEX  <  .ndx  or  .mdx  file  list  >  ] 
EXCLUSIVE  [ALIAS  <  alias  >  ] 

where  <  alias  >  is  an  alias  name  (which  may  be  the  same  as  its  filename),  a 
work  area  letter,  a  work  area  number,  or  an  indirect  reference. 


Defaults 

USE,  without  any  parameters,  closes  the  active  database  and  index  files  in 
the  currently  selected  work  area. 

Unless  otherwise  specified,  dBASE  IV  assumes  a  .dbf  extension  for  the  file 
name,  a  .dbt  extension  for  the  memo  file,  and  an  .ndx  extension  for  the 
index  files. 


Usage 

The  USE  EXCLUSIVE  command  opens  a  file  with  a  file  open  attribute  of 
exclusive  and  a  file  access  attribute  of  read/write.  If  the  file  specified  is 
already  open,  it  is  closed  and  reopened  in  exclusive  mode. 

The  reserved  word  EXCLUSIVE  can  be  specified  either  at  the  end  of  the 
command  or  before  or  after  the  filename  parameter. 


Record  Pointer 

If  an  index  file  is  not  in  use  when  the  USE  EXCLUSIVE  command  is  issued, 
the  record  pointer  is  positioned  at  record  1  of  the  database  file.  If  an  index 
file  is  in  use,  the  record  pointer  is  at  the  logical  beginning-of-file. 


Special  Cases 


The  following  commands  require  exclusive  use  of  files: 

INSERT  [BLANK] 

MODIFY  any  option 

PACK 

REINDEX 

RESET 

ZAP 
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Examples 


The  following  example  shows  how  the  EXCLUSIVE  parameter  can  be  added 
to  the  USE  command  to  select  a  file  for  exclusive  use: 


SET  EXCLUSIVE  OFF 
SELECT  A 
USE  Myfile 
SELECT  B 

USE  New_f i 1 e  EXCLUSIVE 


Myfile  is  opened  in  share,  read/write  mode.  New_file  is  opened  in  exclusive, 
read/write  mode.  The  following  code  is  equivalent: 


SET  EXCLUSIVE  OFF 
SELECT  A 
USE  Myfile 
SET  EXCLUSIVE  ON 
SELECT  B 
USE  New.file 


See  Also 

SET  EXCLUSIVE 
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Using  Functions 

Functions  perform  specialized  operations  that  augment  and  enhance  the 
dBASE  commands.  Functions  always  return  a  value  and  must  be  used  as 
expressions  or  in  expressions  following  a  command  verb. 

Table  4-3  lists  the  functions  unique  to  or  enhanced  for  network 
programming.  The  table  lists  the  functions  alphabetically,  briefly 
describes  each  one,  and  shows  the  type  of  the  value  returned  by  the 
function. 


Table  4-3  Network  programming  function  summary 


Function  Name 

Description 

Output  Data 
Type 

ACCESSQ 

Returns  a  user  access  level 

N 

CHANGEO 

Determines  whether  a  record  has  been 
changed  * 

L 

COMPLETEDQ 

Determines  if  a  transaction  has  been 
completed 

L 

ERROR() 

Returns  the  error  number 

N 

FLOCK() 

Attempts  to  lock  a  database  file  and 
returns  a  success  value  * 

L 

ISMARKEDQ 

Determines  if  a  transaction  is  in  progress 

L 

LKSYSQ 

Determines  who  has  locked  a  record  or 
file  and  the  date  and  time  it  was  locked  * 

C 

MESSAGE() 

Returns  an  error  message  character  string 

C 

NETWORKO 

Determines  if  the  network  version  of 
dBASE  IV  is  running 

L 

RLOCK()/LOCK() 

Attempts  to  lock  a  record  and  return  a 
success  value  * 

L 

ROLLBACK() 

Determines  whether  the  last  ROLLBACK 
command  was  successful 

L 

USERQ 

Returns  the  name  of  the  user  logged  in  to 
a  protected  system 

C 

*  Intended  for  use  in  network  programming  only.  Functions  that  do  not  have 
an  asterisk  following  their  descriptions  are  available  in  single-user  and  net¬ 
work  programming. 
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ACCESS() 


ACCESS()  returns  the  access  level  of  the  last  logged-in  user,  as  it  was  set  in 
PROTECT. 


Syntax 

ACCESSQ 


Usage 


The  ACCESS( )  function  allows  you  to  build  security  in  a  network  application 
program.  The  access  level  returned  by  this  function  can  be  used  as  a  test  to 
control  program  command  sequence. 


Programming  Notes 

Using  the  ACCESSQ  function,  you  can  easily  determine  if  a  user  has  author¬ 
ity  to  proceed  with  a  module  in  a  program.  The  following  example  tests  the 
user  access  level  to  determine  if  it  is  less  than  3: 


IF  ACCESS* )  <  3 


You  may  not  want  anyone  to  be  able  to  modify  access  controls  implemented 
through  the  ACCESSQ  function.  Use  the  COMPILE  command  to  create  a 
.dbo  file,  save  the  .prg  file  to  disk,  and  then  delete  the  .prg  file. 


Special  Cases 

If  dBASE  IV  does  not  find  the  Dbsystem  .db  file  during  startup,  it  does  not 
present  the  log-in  screen  to  the  user.  ACCESS( )  returns  a  zero  if  the  user  has 
not  entered  dBASE  IV  through  the  log-in  screen.  A  user  with  an  access  level 
of  zero  cannot  access  encrypted  files.  To  prevent  ACCESSQ  from  returning  a 
zero,  it  is  recommended  that  you  keep  the  Dbsystem. db  file  in  the  same  dir¬ 
ectory  as  dBASE  IV,  and  always  enter  through  the  log-in  screen. 

If  you  write  programs  that  use  encrypted  files,  check  the  user's  access  level 
early  in  the  program.  If  ACCESSQ  returns  a  zero,  your  program  might 
prompt  the  user  to  log  in  again,  or  to  contact  the  Network  Administrator 
for  assistance. 

In  a  single-user  environment,  ACCESSQ  always  returns  a  zero. 
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ACCESSO 


Example 

In  the  following  example,  the  user’s  ability  to  execute  the  code  is  determined 
by  testing  the  user's  access  level  with  the  ACCESS( )  function: 


DO  WHILE  .T. 

?  "D  Enter  chart  of  accounts1' 

*  &&  More  menu  options 

ACCEPT  "Enter  choice  "  TO  Choice 
DO  CASE 

CASE  Choice-'T" 

IF  ACCESS ()<3 
DO  Program 
ELSE 

?  "ACCESS  NOT  ALLOWED" 
WAIT 
LOOP 
ENDIF 

CASE  choice-" 2" 


ENDCASE 

ENDDO 


See  Also 

FLOCKO,  PROTECT(),  RLOCK(),  UNLOCKQ,  USERQ 
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CHANGE() 


CHANGE()  allows  you  to  determine  whether  a  record  has  been  changed 
since  it  was  opened. 


Syntax 

CHANGE([  <  alias  >  ]) 

where  <  alias  >  is  an  alias  name  (which  may  be  the  same  as  its  filename),  a 
work  area  letter,  a  work  area  number,  or  an  indirect  reference. 


Usage 

The  CHANGEQ  function  checks  the  field  added  by  the  CONVERT  command, 
to  see  whether  the  current  record  has  been  changed.  The  CHANGE( )  func¬ 
tion  returns  a  logical  true  (.T.)  if  the  current  record  has  been  changed,  or  a 
logical  false  (.F.)  if  the  current  record  has  not  been  changed. 

You  must  issue  the  CONVERT  command  before  you  use  CHANGEQ.  If  you 
attempt  to  use  CHANGEQ  before  issuing  the  CONVERT  command,  the  sys¬ 
tem  returns  .F. 


Example 


USE  employee 
DO  WHILE  .NOT.  EOFO 

STORE  LASTNAME  TO  M_LASTNAME 
STORE  SALARY  TO  M_SALARY 
@  5,5  SAY  "LASTNAME" 

@  6,5  SAY  "SALARY" 

@  6,5  SAY  "PRESS  ANY  KEY  TO  VIEW  NEXT  RECORD" 

@  5,16  GET  M  LASTNAME 
0  6,16  GET  M  SALARY 
CLEAR  GETS 
1-0 

DO  WHILE  IoO 
MNKEYO 
IF  CHANGE 0 

STORE  LASTNAME  TO  M_LASTNAME 
STORE  SALARY  TO  M  SALARY 
0  5,16  GET  M_LASTNAME 
0  6,16  GET  M  SALARY 
CLEAR  GETS 
ENDIF 
ENDDO 
SKIP 
ENDDO 

- T 
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CHANGE() 


See  Also 

CONVERT,  LKSYS(),  RL.OCK() 
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COMPLETED() 


COMPLETED( )  allows  you  to  determine  whether  a  transaction  has  ended. 


Syntax 

COMPLETEDO 


Usage 


The  COMPLETEDO  function  returns  a  logical  true  (.T.)  if  a  transaction  is 
not  in  process  or  a  logical  false  (.F.)  if  a  BEGIN  TRANSACTION  command 
has  been  executed.  The  value  of  the  function  is  reset  to  a  logical  true  when 
an  END  TRANSACTION  command  is  executed  or  when  a  ROLLBACK  is 
completed. 


Example 


The  following  example  checks  to  see  if  a  transaction  has  finished  and  dis¬ 
plays  a  ****  TRANSACTION  SUCCESSFULLY  COMPLETED  ****  message. 


USE  employee  TAG  status 
BEGIN  TRANSACTION 

REPLACE  ALL  salary  WITH  salary  *  1.1  FOR  department  -  "SALES" 
END  TRANSACTION 
IF  COMPLETEDO 

*  when  true,  indicates  a  completed  transaction  session 
clear 

@  10,20  SAY  "**♦*  TRANSACTION  SUCCESSFULLY  COMPLETED  ****" 
@  12,20  SAY  "****  SALARIES  HAVE  BEEN  INCREASED  ****" 

ENDIF 


See  Also 

BEGIN  TRANSACTION,  END  TRANSACTION,  RESET,  ROLLBACK, 
ROLLBACK!) 
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ERROR() 


ERROR( )  returns  the  number  of  an  error. 

Syntax 

ERROR() 

Usage 

The  ERROR( )  function  returns  the  error  code  of  the  condition  that  caused 
an  error.  ERRORQ  is  used  within  an  error  processing  routine;  it  can  only  be 
used  when  ON  ERROR  is  being  used  to  trap  errors.  In  network  program¬ 
ming,  you  use  the  ERROR()  function  to  trap  recoverable  error  conditions, 
such  as  attempts  to  lock  an  already  locked  file  or  record.  The  value  returned 
by  ERROR()  is  numeric. 


Programming  Notes 

ON  ERROR  must  be  active  for  this  function  to  receive  a  value.  If  RETRY  or 
RETURN  is  used  within  the  ON  ERROR  procedure,  the  ERROR()  value  is 
replaced  by  zeroes  when  f  ither  of  these  commands  is  processed. 


Tips 

The  MESSAGEQ  function  obtains  the  dBASE  error  message. 

The  CANCEL  command  terminates  execution  of  an  application  program 
when  the  error  is  not  recoverable.  In  debug  mode,  the  SUSPEND  command 
terminates  execution. 
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ERROR() 


Example 


The  following  example  u$es  the  value  returned  by  the  ERROR()  function  to 
establish  the  condition  for  execution  of  commands  and  passes  the  value  of 
ERROR( )  to  a  procedure: 


************************************************************ 

*  Error  Program  * 

*★★**★★******★***★***★*★★*★****★★*******★★★★***★**★★***★★**★ 


00  CASE 

CASE  ERROR  0  -  108 
Time  -  1 

00  WHILE  Time  <  100 
Time  =  Time  +  1 
ENDD0 

IF  Trys  >  10 
Trys  -  Trys  +  1 
RETRY 
ELSE 

?  "File  is  locked  -  can't  proceed" 
WAIT 

RETURN  TO  MASTER 
END  IF 

CASE  ERROR!) -25 
* 


&&  File  is  in  use  by  another  error 
&&  Delay  loop 

&&  Trys  is  a  PUBLIC  variable 
&&  Retry  opening  file 


ENDCASE 


See  Also 


MESSAGE*),  RETRY 

CANCEL,  DO  CASE,  ON  ERROR,  RETURN,  and  SUSPEND  in  the  Language 
Reference  manual 

The  section  “Errors  and  Error  Recovery”  in  Chapter  2 

The  complete  list  of  error  messages  and  codes  in  the  Language  Reference 
manual  (Appendix  A) 
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FLOCK() 


PLOCK( )  attempt*  to  lock  a  database  file  and  return*  a  J  if  successful. 


Syntax 

FLOCKff  <  alias  >  ]) 

where  <  alias  >  is  an  alias  name  (which  may  he  the  same  as  its  filename),  a 
work  area  letter,  a  work  area  number,  or  an  indirect  reference. 


Usage 

The  FLOCK!)  function  is  a  programming  feature  to  prevent  file  update  colli¬ 
sion.  A  collision  occurs  when  two  users  try  to  update  a  file  at  the  same  time 
To  avoid  the  collision,  the  first  user  to  get  access  must  lock  the  file  with  the 
FLOCK( )  function. 

Jf  the  file  lock  attempt  is  suet  essful,  dBASP,  JV  opens  the  file  for  the  user's 
private  use,  and  FLOCK ( )  returns  a  logical  true  (,T  ).  The  file  remains  locked 
until: 

■  Jt  is  unlocked  by  the  UNLOCK  command,  or 
m  An  operation  closes  the  file,  or 

■  The  user  quits  dBASF.  JV 

A  lot  ked  file  <  ah' t  be  modified  by  another  workstation  until  the  lock  is 
released  However,  the  lock  is  a  shared  lock  and  users  at  other  workstations 
can  view  the  file. 

If  the  file  id  already  locked  by  another  user,  FLOCK( )  returns  a  logir  al  false 

IP). 

FJ.OCKO  is  effective  for  operations  that  can  change  many  ret  orris  in  a  file 
and  <  an  r  hange  many  index  files. 

Use  the  I'l  Of  K()  flint  firm  to  lor  k  all  the  records  in  a  file  for  whole  file  type 
operations  Use  fh'  PI  Of  K( )  ot  LOCK!)  function  to  lor  k  one  record  in  a  file 
for  more  effir  lent  multi  user  file  access 

If  yrm  lor  k  a  file  while  it  is  ar  tively  related  to  other  open  files,  then  all  the 
files  in  the  relation  ar  r*  antornatir  ally  locked  Unlocking  any  one  of  the 
related  files  aufomarlr  ally  unlor  ks  the  other  files. 
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FLOCK() 


Tips 

File  locking  is  most  useful  for  whole  file  update  operations,  such  as  custom¬ 
ized  report  programs  or  batch  type  operations.  Generally,  FLOCK( )  locking 
should  not  be  used  if  the  end  user  intervenes  during  the  transaction  cycle 
(that  is,  if  there  is  an  @  <  row  >  ,  <  col  >  GET/READ  sequence  in  the 
update  sequence). 


Examples 


Assume  that  TriaLbal.dbf  contains  trial  balances  and  Transact.dbf  contains 
transaction  debits  and  credits.  The  following  dBASE  program  uses  the 
FLOCKQ  function  to  lock  TriaLbal.dbf  while  it  is  being  updated: 


*Trial_bal  is  opened  as  a  shared  file  with  read/write  access.* 
♦Transact  is  opened  as  an  exclusive  use  file.  * 


SET  EXCLUSIVE  OFF 
SELECT  A 

USE  Trial.bal  INDEX  Accts 
SELECT  B 

!  USE  Transact  EXCLUSIVE 
;  PUBLIC  Time 

***★★***************★★★★***★★*★★★★*★**★★★★****★★*★***★*★★★★★★* 
|  *  Perform  a  wait  loop;  that  is,  wait  until  FLOCKO  is  TRUE  * 

j  *  but  on  the  250th  test,  if  FLOCKO  is  still  not  TRUE,  error  * 

*  out.  * 

!  ★****★*****★*★*****★****★★★***★★★*★★*********************★★★★★ 


SELECT  A 
Time-1 

DO  WHILE  .NOT.  FLOCKO  .AND.  Time<250 
Time-Time+1 
ENDDO 

IF  .NOT.  FLOCKO  &&  The  lock  will  be  tried  one  more  time  with  this  command. 
DO  Time  out 
RETURN 
ENDIF 

ft************************************************************* 

*  Now  the  file  Trial_bal  is  locked  and  updated.  * 

★★★♦I.'**************-***********************************'******** 
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1700 


FLOCK() 


- j_ 

SELECT  B 
GO  TOP 

00  WHILE  .NOT.  EOFO 
STORE  ACCOUNT  TO  Mkey 
SELECT  A 
SEEK  Mkey 

IF  .NOT.  EOFO 

REPLACE  Ac.debit  WITH  Ac.debit  +  Trns.dbt,; 

Ac_credit  WITH  Ac  credit  +  Trns_cdt 

ENDIF 
SELECT  B 
SKIP 
ENDDO 
SELECT  A 
UNLOCK 


See  Also 

RLOCK()/LOCK(),  UNLOCK 
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ISMARKEDO 


ISMARKEDO  checks  the  current  work  area  or  the  optional  alias  to  deter¬ 
mine  if  a  database  file  is  having  transaction  updates  added  to  it  and  is  in  an 
inconsistent  state. 


Syntax 

ISMARKED([  <  alias  >  ]) 

where  <  alias  >  is  an  alias  name  (which  may  be  the  same  as  its  filename),  a 
work  area  letter,  a  work  area  number,  or  an  indirect  reference. 


Usage 

This  function  indicates  whether  a  database  is  in  a  constant  state  or  in  a  state 
of  change.  If  the  database  is  marked  for  change,  this  function  returns  a  logi¬ 
cal  true  (.T.).  If  the  database  file  is  not  marked,  this  function  returns  a  logi¬ 
cal  false  (.F.). 


Example 

The  following  example  checks  to  see  if  a  transaction  is  in  progress  and  either 
delays  the  replacement  of  variables  when  a  transaction  is  in  progress  or 
replaces  the  variables  if  one  is  not  in  progress. 


USE  customer 
IF  ISMARKEDO 

@  5,5  SAY  "The  file  you  need  has  an  active  transaction  on  it." 
@  6,5  SAY  "Please  try  again  later." 

RETURN 

ELSE 

REPLACE  ALL  salary  WITH  salary  *1.1 
ENDIF 


I 

See  Also 

BEGIN  TRANSACTION,  COMPLETED*),  END  TRANSACTION,  RESET, 
ROLLBACK,  ROLLBACK*) 
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LKSYS() 


LKSYS( )  determines  who  has  locked  a  record  or  a  file  and  the  date  and  time 
it  was  locked. 


Syntax 

LKSYS(  <  expN  >  ) 

Usage 

The  CONVERT  command  must  be  used  prior  to  executing  this  function.  The 
LKSYS( )  function  converts  the  values  in  the  —DBASELOCK  field  from  hexa¬ 
decimal  to  ASCII,  and  returns  a  value  for  the  specified  argument. 

There  are  three  arguments  in  this  function: 

expN  =  0  returns  the  time  when  the  lock  was  placed. 
expN  =  1  returns  the  date  when  the  lock  was  placed. 
expN  =  2  returns  the  log-in  name  of  the  user  who  locked  the  record. 

The  field  itself  cannot  be  listed  or  displayed,  but  the  LKSYSQ  function  will 
return  values  stored  in  the  field. 


Examples 


The  following  example  returns  the  user  ID  of  the  user  who  locked  the 
record: 


user  lock  «  LKSYS<2) 

0  22,5  SAY  "The  data  record  is  LOCKED  ..." 

0  23,5  SAY  "Last  locked  by:" 

0  23,21  SAY  userjock 

If  a  user  named  BILLC  locked  a  record,  the  variable  user-lock  would  dis¬ 
play  his  user  ID,  as  follows: 

The  data  record  is  LOCKED  ... 

Last  locked  by:  BILLC 

The  following  example  displays  the  time  the  current  record  was  locked: 

.  DISPLAY  LKSYS(O) 

See  Also 


CHANGEO, CONVERT 
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MESSAGE( )  returns  an  error  message  character  string. 


Syntax 

MESSAGE!) 


Usage 

The  MESSAGE!)  function  allows  the  network  programmer  access  to  system 
error  message  strings.  The  program  can  display  the  error  messages  on  the 
screen,  or  can  store  them  to  a  variable. 

ON  ERROR  must  be  active  for  this  function  to  receive  a  value.  If  RETRY  or 
RETURN  is  used  within  the  ON  ERROR  procedure,  the  MESSAGE!)  string 
becomes  unavailable  after  either  command  is  processed. 


Examples 

The  following  error  procedure  retries  to  lock  a  file  if  error  108  occurs  or  to 
lock  a  record  if  error  109  occurs.  It  also  provides  for  the  system  displaying 
the  text  of  the  error  message,  if  any  other  error  is  encountered. 


DO  CASE 

CASE  ERROR!  M08 
RETRY 

CASE  ERROR! )-109 
RETRY 
OTHERWISE 

@21,15  SAY  MESSAGE!) 
ENDCASE 


See  Also 

ERROR!) 

Network-specific  error  messages  (Appendix  A  of  this  manual) 

The  complete  list  of  error  messages  and  codes  in  the  Language  Reference 
manual  (Appendix  A) 
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NETWORK() 


NETWORK()  indicates  whether  the  network  version  of  dBASE  IV  is  running. 


Syntax 

NETWORK* ) 


Usage 

This  function  returns  a  logical  true  (.T.)  if  the  multi-user  version  of 
dBASE  IV  is  running,  and  a  logical  false  (.F.)  if  the  single-user  version 
is  running. 

Example 


i  IF  NETWORK!) 

ACCEPT  "Do  you  want  to  see  who  else  is  logged  in?"  TO  answer 
IF  UPPER(answer)-"Y" 

DISPLAY  USER 
ENDIF 
|  ENDIF 
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RLOCK(  )/LOCK( ) 


RLOCK()/LOCK()  is  used  to  lock  multiple  records.  The  two  function  names 
are  interchangeable. 


Syntax 

RLOCK([  <  expC  list  >  ,  <  alias  >  ]/[  <  alias  >  ]) 
or 

LOCK([  <  expC  list  >  ,  <  alias  >  ]/[  <  alias  >  ]) 

where  <  alias  >  is  an  alias  name  (which  may  be  the  same  as  its  filename),  a 
work  area  letter,  a  work  area  number,  or  an  indirect  reference. 


Usage 

RLOCK( )  or  LOCK( )  allows  programs  to  coordinate  multiple  transaction 
sequences.  A  lock  on  a  record  prevents  different  transactions  from  gaining 
simultaneous  access  to  the  same  record.  However,  the  lock  is  a  shared  lock 
and  users  at  other  workstations  can  view  the  file. 

Record  locking  is  a  control  mechanism  that  prevents  multiple,  serial  data¬ 
base  transactions  from  interfering  with  each  other.  The  process  for  a  serial 
database  transaction  requires  three  operations:  read  data,  modify  data,  write 
data. 


The  RLOCK()/LOCK()  function  enables  multiple  transaction  sequence  con¬ 
trol  without  the  need  to  lock  all  the  information  in  a  file.  It  enables  locking 
of  only  the  data  to  be  changed.  The  other  records  of  the  shared  file  are  left 
free  for  use  by  other  users. 

The  RLOCK()/LOCK()  function  locks  the  records  whose  numbers  are  in 
the  numeric  expression  list.  In  addition,  all  other  records  that  are  related 
to  the  records  in  the  list  are  locked.  Records  are  related  if  you  use  the  SET 
RELATION  command.  The  maximum  number  of  records  that  can  be  locked 
by  RLOCK()/LOCK()  is  50.  If  you  attempt  to  LOCK  more  than  50  records, 
the  system  returns  the  error  message  Lock  table  is  full. 

If  you  do  not  use  a  record  number  list,  then  the  current  record  in  the  speci¬ 
fied  alias  is  used. 

If  all  the  records  in  the  list  and  all  other  records  related  to  them  can  be 
locked,  the  RLOCK()/LOCK()  function  returns  a  logical  true  (.T.)  and  locks 
all  of  the  records.  Otherwise,  the  function  returns  a  logical  false  (.F.),  indi¬ 
cating  that  one  of  the  records  is  already  locked. 

The  RLOCKO  function  is  additive;  it  does  not  unlock  the  previous  locked 
records.  A  locked  record  is  not  unlocked  until  you  issue  an  UNLOCK  com¬ 
mand  or  an  FLOCK()  function. 
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RLOCK()/LOCK() 


Examples 

The  RLOCK()/LOCK()  function  attempts  to  lock  the  specified  records  in  the 
active  database  file  if  a  numeric  expression  list  is  included  and  an  alias  name 
is  not  specified: 


RLOCKC'3,5,8") 


If  you  specify  an  alias  name  without  specifying  a  numeric  expression  list,  an 
attempt  is  made  to  lock  the  current  record  number  in  the  alias  file: 


RLOCK ( " A1 i as_f i 1 e" ) 


If  you  specify  both  a  numeric  expression  list  and  an  alias  name,  an  attempt  is 
made  to  lock  the  specified  records  in  the  alias  file: 


RLOCK ("3,5,8", "A1 i as_f i 1 e" ) 


The  following  example  uses  the  RLOCK(  )  function  without  a  specified 
expression  list  or  alias  name: 


00  WHILE  .NOT.  RLOCK 0 
DO  TIMER 
IF  TIMES  UP 
?  CHRI7) 

DO  SHOW.MSG  WITH  "TIME-OUT  ON  WAITING  FOR  REC0R0  TO  UNLOCK..." 

?  CHR(7T 
ON  KEY  LOOP 

DO  SHOW  MSG  WITH  "PRESS  ESC  KEY  TO  EXIT  OR  SPACE  KEY  TO  CONTINUE  WAITING..." 
ENDIF 
ENDDO 


See  Also 

FLOCKQ,  SET  RELATION,  UNLOCK 
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ROLLBACK*) 


ROLLBACK*)  determines  whether  the  last  ROLLBACK  command  was 
successful. 


Syntax 

ROLLBACK*) 


Usage 

This  function  returns  a  logical  true  *.T.)  if  the  last  ROLLBACK  command 
was  successful.  If  the  ROLLBACK  command  was  not  successful,  this  func¬ 
tion  remains  false  until  there  is  a  successful  ROLLBACK,  or  until  you  exit 
dBASE  IV. 


Example 

The  following  program  (from  the  sample  applications)  is  an  example  of 
how  the  BEGIN  TRANSACTION,  ROLLBACK,  and  END  TRANSACTION 
commands  can  be  used  to  create  a  transaction  log  file  and  perform  a 
recovery  using  that  file. 


USE  employee  TAG  status 
BEGIN  TRANSACTION 

REPLACE  ALL  salary  WITH  salary  *  1.055  FOR  department  -  "SALES" 

END  TRANSACTION 
IF  completed!) 

*  when  true,  indicates  a  completed  transaction  session 
clear 

9  10,20  SAY  "****  TRANSACTION  SUCCESSFULLY  COMPLETED  ****" 

9  12,20  SAY  "****  SALARIES  HAVE  BEEN  INCREASED  ****" 

ELSE 

*  when  false,  indicates  problems  in  the  transaction  session 
clear 

?  chr (7) 

9  10,20  SAY  "****  TRANSACTION  NOT  SUCCESSFUL  ****" 

9  12,20  SAY  "****  ROLLBACK  COMMENCING  ...  ****" 

ON  ERROR  DO  err_proc 
ROLLBACK  employee 
IF  rollback!) 

*  when  true,  indicates  a  successful  rollback  to  initial  state 
9  16,20  SAY  "****  ROLLBACK  COMPLETE.  ****" 

9  18,20  SAY  "****  CHECK  YOUR  DATA  BEFORE  ****" 

9  20,20  SAY  "****  RUNNING  THIS  PROGRAM  AGAIN...  ****" 
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ROLLBACK!) 


ELSE 

*  when  false,  indicates  an  unsuccessful  rollback 
?  chr ( 7 ) 

0  16,20  SAY  "****  ROLLBACK  FAILED .  ****" 

9  18,20  SAY  "****  CHECK  YOUR  DATA  BEFORE  ****" 

9  20,20  SAY  "****  RUNNING  THIS  PROGRAM  AGAIN...  ****" 

WAIT 

IF  I SMARKED( employee) 

*  integrity  flag  remains  in  database-incomplete  rollback 
?  chr(7) 

@  18,20 

@  20,20  SAY  "****  DATABASE  STILL  CONTAINS  INTEGRITY  FLAG.  ****" 

@  21,20  ACCEPT  "RESET  DATABASE  FROM  ROLLBACK  ?  (Y/N)"  TO  reset  db 
IF  UPPER(reset_db)  =  "Y" 

RESET  IN  employee 

0  22,20  SAY  "DATABASE  RESET  —  MANUALLY  RECOVER..." 

@  23,20  SAY  "CHECK  DATA  AND  RERUN  THIS  PROGRAM..." 

ELSE 

?  chr (7) 

0  22,20  SAY  "DATABASE  NOT  RESET  —  MANUALLY  RECOVER..." 

0  23,20  SAY  "CHECK  DATA  AND  RERUN  THIS  PROGRAM..." 

ENDIF 

WAIT 

ENOIF 

ENDIF 

ENDIF 

************************  END  of  TRANSACT. PRG  ************************* 


See  Also 

BEGIN  TRANSACTION,  COMPLETED!),  END  TRANSACTION,  ERROR! ), 
ISMARKEDO,  RESET,  ROLLBACK 

The  complete  list  of  error  messages  and  codes  in  the  Language  Reference 
manual  (Appendix  A) 
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USER() 

USER( )  indicates  the  user  name  of  the  user  logged  in  to  a  protected  system. 


Syntax 

USER() 

Usage 

This  function  returns  the  name  of  the  user  logged  in  at  a  workstation.  The 
system  must  be  protected  for  a  name  to  be  returned.  If  the  system  is  not  pro¬ 
tected,  this  function  returns  a  null  string. 

Example 

|  .  ?  USERO 

;  FRED 

See  Also 

PROTECT 
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Administrator 
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dBASE 

Security 


About  This  Chapter 

This  chapter,  which  describes  how  to  use  the  PROTECT  security  command, 
discusses  the  following: 

■  PROTECT  security  concepts,  including  levels  of  security 

■  Using  PROTECT  menus  to  set  up  a  security  system 

■  Dbsystem.db,  the  user  security  file 

■  Operational  considerations  that  affect  network  security 


NOTE 

SQL  users  should  refer  to  Using  dBASE  IV  SQL  for  information  about 
securing  data  in  the  SQL  environment. 


About  dBASE  Security 

The  PROTECT  command  is  used  to  create  and  maintain  security  on  a 
dBASE  IV  system.  PROTECT  is  a  menu-driven  command  issued  inside 
dBASE  IV  by  the  database  administrator  who  is  responsible  for  data  security. 
PROTECT  may  be  used  on  a  single  microcomputer  or  in  a  local  area 
network  environment. 

PROTECT  is  optional:  you  don't  have  to  use  it.  Once  you  have  used 
PROTECT,  however,  the  security  system  will  always  control  access  to 
database  files. 

PROTECT  includes  three  distinct  types  of  database  protection: 

■  Log-in  security,  which  prevents  access  to  dBASE  IV  by  unauthorized 
personnel 

■  File  and  field  access  security,  which  allows  you  to  define  what  files,  and 
fields  within  files,  each  user  can  access 

■  Data  encryption,  which  enciphers  dBASE  files  so  that  unauthorized  users 
cannot  read  them 
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Table  5-1  summarizes  the  database  security  types,  how  to  implement  each 
security  type,  and  the  results  of  security  implementation. 


Table  5-1  dBASE  security  summary 


Security  Type  You  Define: 

Log-in  User  name  and  password 


File  and  Field  Access  levels 

Access 

Data  Encryption  User  and  file  group 


You  Get: 

Control  over  access  to 
dBASE  IV 

Control  over  access  to  data 
files  and  fields  in  data  files 

Automatic  encryption  and 
decryption  of  data 


The  security  types  listed  in  Table  5-1  and  described  more  fully  in  this  chapter 
constitute  levels  of  security.  Log-in  security  is  the  first  security  level.  Once  a 
security  system  is  in  place,  users  cannot  access  dBASE  IV  until  they  pass  log¬ 
in  security.  Access  control  is  the  next  security  level.  Access  control  deter¬ 
mines  what  a  user  can  do  both  with  a  database  file  and  data  in  the  file,  and 
can  be  used  to  control  processing  of  application  code.  Data  encryption 
scrambles  the  database  so  that  unauthorized  users  cannot  read  the  informa¬ 
tion  in  the  file. 

You  must  implement  the  security  types  in  the  order  shown  above.  You  can¬ 
not  establish  file  and  field  access  control  without  first  creating  log-in  secu¬ 
rity.  Similarly,  you  must  create  both  log-in  security  and  file  and  field  access 
control  in  order  to  have  c  ata  encryption.  However,  it  is  not  necessary  to 
implement  all  three  levels  of  security.  Many  database  administrators  elect  to 
implement  just  log-in  security. 

If  you  decide  to  use  PROTECT,  you  must  create  a  user  profile  for  each  opera¬ 
tor.  See  “Creating  User  Profiles,”  later  in  this  chapter. 


Log-in  Security 

PROTECT  allows  you  to  create  a  password-protected  system.  If  password 

protection  is  in  force: 

■  No  user  can  gain  access  to  dBASE  IV  on  that  system  unless  the  user 
enters  a  valid  login.  The  login  consists  of  three  items:  a  group  name, 
a  log-in  name,  and  a  password. 

■  PROTECT  displays  the  user  log-in  screen  whenever  you  access 
dBASE  IV.  All  paths  into  the  database  system  initiate  the  log-in  process. 
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Access  Level  Security 

You  control  access  to  database  files  and  fields  within  those  files  by  assigning 
user  access  levels  that  determine  the  user's  file  access  and  field  access 
privileges.  The  file  access  privileges  and  the  field  access  privileges  for  a  file 
are  called  its  privilege  scheme. 

User  access  levels  are  numbered  1  through  8.  Assigning  a  low  number  gives 
the  user  greater  access  privileges.  Assigning  a  higher  number  limits  the 
user’s  access. 

You  establish  an  access  level  for  each  user  in  the  user’s  profile,  and 
additional  access  levels  for  file  and  field  privileges  in  the  file  privilege 
scheme. 

After  you  log  in,  dBASE  IV  determines  what  access  level  you  have  with  a  file 
by  matching  the  user  access  level  with  the  file’s  privilege  scheme. 

You  can  assign  any  number  of  users  to  each  access  level,  but  only  one  access 
level  to  the  same  user  in  the  same  group.  A  user's  ability  to  access  a  particu¬ 
lar  file  is  a  function  of  both  group  membership  and  access  level.  However, 
only  access  level  determines  what  the  user  can  do  with  the  file  once  it  is 
accessed. 


File  Access  Privileges 

You  establish  privileges  for  a  database  file  by  assigning  access  levels  to  the 
operations  that  a  user  can  do  on  it.  You  can  assign  access  levels,  in  any  com¬ 
bination,  to  read,  update,  extend,  and  delete  privileges.  These  privileges 
grant  users  the  ability  to: 

■  View  records  in  a  database  file  (read  privilege) 

■  Change  database  file  record  contents  (update  privilege) 

■  Append  new  records  to  a  database  file  (extend  privilege) 

■  Delete  records  from  a  database  file  (delete  privilege) 

If  you  do  not  use  PROTECT  to  create  a  privilege  scheme  for  a  database  file, 
all  users  can  read  and  write  to  all  fields  in  the  file.  When  you  use  PROTECT 
to  create  a  file  privilege  scheme,  all  four  file  privileges  sure  granted  initially 
until  you  change  them.  You  change  the  default  by  specifying  the  most 
restricted  level  that  is  to  have  each  privilege. 
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Field  Access  Privileges 

At  the  field  level,  you  can  control  what  operations  each  user  is  allowed.  You 
can  grant  full  (FULL),  read-only  (R/O),  or  no  access  (NONE)  privilege  to 
each  field  in  a  database  file  for  each  access  level.  The  field  privileges  allow 
users  to: 

■  Read  and  write  the  field  in  the  database  file  (FULL  privilege).  This  is  the 
initial  default. 

■  Read  but  not  write  the  field  (R/O  privilege). 

■  Neither  read  nor  write  the  field  (NONE  privilege). 

When  NONE  is  selected,  a  user  is  blocked  from  writing  to  fields  and 
even  from  seeing  fields  you  do  not  want  displayed. 


Data  Encryption 

Data  encryption  scrambles  data  so  that  it  can’t  be  read  until  it  is  unscram¬ 
bled.  An  encrypted  file  contains  data  that  has  been  translated  from  source 
data  to  another  form  that  makes  its  contents  unreadable.  If  your  database 
system  is  PROTECTed,  dBASE  IV  automatically  encrypts  and  decrypts  data¬ 
base  files  and  their  associated  index  and  memo  files. 


The  User  and  File  Group 

When  you  create  each  user's  security  profile,  you  assign  each  user  to  a 
group.  The  user’s  group  must  be  specified  at  login.  As  part  of  each  file's  priv¬ 
ilege  scheme,  you  assign  the  file  to  a  group.  A  file  can  be  assigned  to  only 
one  group.  If  the  user  group  and  file  group  do  not  match,  the  user  cannot 
access  the  file. 


access  files  from  two  different  groups,  the  user  must  log  in  twice, 
specifying  a  different  group  name  at  each  login. 

Typically,  each  group  is  associated  with  a  set  of  files.  By  associating  each 
application  with  its  own  group,  you  use  the  group  to  control  data  access. 
Further,  by  using  access  levels  within  the  group,  you  can  give  different  users 
different  kinds  of  access  to  the  application  program  files. 


NOTE 

A  user  can  belong  to  more  than  one  group.  However,  each  group  that 
a  user  belongs  to  must  be  logged  into  separately.  If  a  user  needs  to 
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The  Dbsystem.db  File 

PROTECT  builds  and  maintains  a  password  system  file,  called  Dbsystem.db, 
which  contains  a  record  for  each  user  who  accesses  a  PROTECTed  system. 
Each  record,  called  a  user  profile,  contains  the  user’s  log-in  name,  account 
name,  password,  group  name,  and  access  level.  When  a  user  enters  the 
dBASE  command  at  a  network  workstation,  dBASE  IV  looks  for  a 
Dbsystem.db  file.  If  it  is  found,  the  log-in  process  is  initiated.  If  it  is  not 
found,  there  is  no  log-in  process. 

Dbsystem.db  is  maintained  as  an  encrypted  file  that  can’t  be  decrypted.  Only 
a  database  administrator  can  print  out  this  information.  (See  the  ’’Printing 
Security  Information”  section  later  in  this  chapter.) 


Creating  a  Security  System 

To  create  a  PROTECTed  database  system: 

1.  Initiate  the  PROTECT  command. 

2.  Define  the  database  administrator’s  password. 

3.  Define  user  profiles. 

4.  Define  file  privilege  levels  and  field  privileges. 

5.  Save  the  security  information. 

The  following  sections  describe  these  steps  in  detail. 


Initiating  PROTECT 

You  initiate  PROTECT  from  within  dBASE  IV  after  all  database  files  have 
been  closed.  To  start  PROTECT  at  the  dot  prompt,  enter  PROTECT  and  press 
*-*.  You  can  also  select  Protect  data  from  the  Control  Center  through  the 
Tools  menu. 


The  Database  Administrator  Password 

When  you  enter  the  PROTECT  command,  the  dBASE  IV  Password  Security 
System  log-in  screen  appears,  as  shown  in  Figure  5-1. 


dBASE  IU  Passuord  Security  System 
Enter  passuord 


Figure  5-1  dBASE  IV  Password  Security  System  log-in  screen 
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Enter  a  password  of  up  to  16  alphanumeric  characters  on  the  log-in  screen. 
You  can  enter  alphabetic  characters  in  upper  or  lower  case.  The  password  is 
not  displayed  on  the  screen.  For  maximum  log-in  security  (and  maximum 
encryption  protection),  you  should  specify  the  full  16  characters  allowed. 

The  first  time  you  use  PROTECT,  the  system  prompts  you  Please  reenter 
password  to  confirm.  You  must  enter  your  password  again.  Thereafter, 
each  time  you  use  PROTECT,  you  enter  the  password  only  once.  The  system 
gives  you  three  chances  to  enter  the  password  correctly  before  PROTECT 
terminates. 


WARNING 

Remembering  the  administrator  password  is  essential.  You  can 
access  the  security  system  only  if  you  can  supply  the  password.  Once 
established,  the  security  system  can  be  changed  only  if  the  adminis¬ 
trator  password  is  supplied  when  PROTECT  is  called.  Keep  a  hard 
copy  of  the  database  administrator  password  in  a  secured  area.  There 
is  no  way  to  retrieve  this  password  from  the  system. 


If  you  pass  security,  the  system  displays  the  Users  menu,  through  which  you 
create  user  profiles. 

Creating  User  Profiles 


The  Users  menu,  shown  in  Figure  5-2,  creates  or  modifies  a  user  profile  in 
the  Dbsystem.db  file. 


Figure  5-2  Users  menu 

You  use  the  Users  menu  to: 

■  Add,  change,  and  delete  user  profiles 

■  Establish  and  change  the  access  level  for  each  user 

To  select  an  option  in  the  menu,  move  the  highlight  (with  f  or  |)  and  press 
«-*,  or  press  the  first  letter  of  the  menu  choice. 
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Adding  a  New  User  Profile 

Follow  the  steps  below  to  add  a  user  profile  to  the  Dbsvstem.db  file: 

1.  Access  the  Users  menu.  The  cursor  is  at  the  first  field,  Login  name. 

Press  «-». 

2.  Enter  a  user  log-in  name  (1-8  alphanumeric  characters).  Press  «-*.  This 
entry  is  converted  to  upper  case. 

3.  The  Password  option  is  highlighted.  Press  4-J.  Enter  a  user  password 
(1-16  alphanumeric  characters).  Press 

4.  The  Group  name  option  is  highlighted.  Press  «-J.  Enter  a  group  name 
(1-8  alphanumeric  characters).  Press  «-*.  This  entry  is  converted  to  upper 
case. 

5.  The  Full  name  option  is  highlighted.  Press  «-*.  Enter  the  full  name 
(1-24  alphanumeric  characters),  if  desired.  Press  «->. 

6.  The  Access  level  option  is  highlighted.  Press  «-*.  Select  a  user  access 
level  (a  number  from  1  through  8). 

7.  The  Store  user  profile  option  is  highlighted.  Press  «-i  to  store  the  user 
profile. 

You  must  specify  a  value  for  log-in  name,  password,  and  group  name,  or  a 

user  profile  will  not  be  created. 

Note  that: 

■  If  you  intend  to  use  SQL,  you  must  add  the  super  user  log-in  name 
SQLDBA,  which  is  granted  privileges  to  all  operations  in  SQL  mode. 

The  SQL  GRANT  and  REVOKE  commands  control  file  and  field  access 
privileges  using  log-in  names  assigned  by  PROTECT. 

■  The  full  name  is  the  only  optional  item  in  a  user  profile.  Since  this 
item  is  not  used  in  validating  a  login,  you  can  use  it  any  way  you  want. 
Frequently,  the  full  name  is  used  to  add  a  more  complete  user  identifica¬ 
tion.  Alphabetic  characters  you  enter  in  the  Full  name  option  will  not  be 
converted  to  upper-case  characters. 

■  You  may  find  it  useful  to  organize  users  and  files  into  groups  that  reflect 
application  use  (see  "The  User  and  File  Group”  section  above). 

■  The  user  group  name  will  be  matched  with  the  file  group  name  to 
enable  file  access. 

■  Within  each  group,  the  user  is  assigned  an  access  level.  This  level  will  be 
matched  with  file  access  levels  established  with  the  Files  menu  to  deter¬ 
mine  what  access  level  the  user  has  for  each  database  file.  It  will  also 
determine  the  type  of  access  the  user  has  to  each  file  and,  within  each 
file,  to  each  field.  See  the  "Establishing  File  Privilege  Levels"  section 
below  for  a  discussion  of  access  levels  and  how  they  should  be  assigned. 
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When  you  have  entered  all  the  items,  you  must  select  Store  user  profile  to 
save  the  new  profile.  You  can  then  do  one  of  the  following: 

■  Return  to  the  first  option  on  the  menu  (Login  name),  and  begin  enter¬ 
ing  another  user  profile  #  • 

■  Move  to  another  menu  by  pressing  +-  or  -► 

At  any  time  during  the  definition  or  modification  of  a  user  profile,  you  can 
terminate  the  process.  The  user  profile  information  is  not  saved  until  you 
store  it. 

Changing  a  User  Profile 

When  you  enter  the  first  three  items  on  the  Users  menu  (Login  name. 
Password,  and  Group  name),  PROTECT  checks  to  see  if  the  user  profile 
has  already  been  defined.  If  it  has,  the  rest  of  the  menu  items  are  completed 
with  their  current  values.  You  can  then  change  any  of  the  values,  but  it  is 
recommended  that  you  do  not  change  the  group  name. 

To  change  a  user  profile,  follow  the  steps  below: 

1.  Open  the  Users  menu. 

2.  Enter  the  log-in  name,  password,  and  group  name  of  the  user  profile  you 
want  to  change. 

3.  Enter  Y  in  response  to  the  User  already  exists,  do  you  want  to  edit? 

prompt. 

4.  Press  f  to  highlight  the  Login  name  field  or  the  Password  field. 

Press  4-1.  Do  not  change  the  group  name. 

If  you  edit  the  group  name,  there  will  be  no  way  to  access  files  associated 
with  the  original  name.  You  also  should  not  delete  the  group.  If  you  delete 
a  group  name  before  all  files  associated  with  the  group  are  copied  out  in  a 
decrypted  form,  no  one  can  access  the  files. 

Remember  that  you  will  need  to  enter  the  user  profile  changes  and,  later, 
save  them.  (See  the  “Adding  a  New  User  Profile”  section  above.) 

Deleting  a  User  Profile 

The  last  option  on  the  Users  menu  is  used  to  delete  a  user  profile.  Follow 
the  steps  below: 

1.  Open  the  Users  menu. 

2.  Enter  the  log-in  name,  the  password,  and  the  group  name. 

3.  Move  the  highlight  to  Delete  user  from  group. 

4.  Press  «-J. 
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File  Privilege  Schemes 

The  Flies  menu  creates  or  modifies  file  privilege  schemes  in  which  file  and 
field  privileges  are  assigned  to  match  user  access  levels.  The  file  privilege 
schemes  are  saved  in  the  database  file  structure.  Press  >•-  or  -►  to  move  to 
the  Files  menu,  illustrated  in  Figure  5-3. 


Figure  5-3  Files  menu 


You  use  the  Files  menu  to: 

■  Assign  a  file  to  a  specific  group. 

■  Create  and  change  access  levels  for  file  privileges.  You  can  define  up  to 
eight  levels  of  privilege  for  each  file. 

■  Assign  field  access  privileges  for  each  file  access  level. 

To  select  an  option  in  the  menu,  use  the  f  or  i  key  to  move  the  highlight  to 
the  desired  option  and  press  ♦J,  or  press  the  first  letter  of  the  menu  choice. 


Creating  a  File  Privilege  Scheme 

Follow  the  steps  below  to  define  file  and  field  privileges  for  a  database  file: 

1 .  Access  the  File*  menu. 

2.  Select  a  file. 

3.  Assign  the  file  to  a  specific  group. 

4.  Establish  the  most  restrictive  access  level  for  each  file  privilege. 

5.  Select  an  access  level  for  field  privilege  assignment. 

6.  Select  field  privileges  for  each  field  at  each  access  level,  as  required. 

7.  Store  the  file  and  field  privilege  scheme. 

The  sections  that  follow  describe  these  steps  in  detail. 
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A  file  is  not  encrypted  unless  you  select  it  (New  file),  store  it  (Store  file 
privileges),  and  save  it  (Exit).  With  these  choices,  you  can  change  the  file 
privilege  scheme  or  accept  the  preset  menu  values  for  the  privileges.  These 
values,  also  called  default  values,  are  set  as  follows: 

■  The  access  levels  for  all  file  privileges  are  set  to  8 

■  Field  privileges  are  set  to  FULL 

If  these  access  level/privilege  associations  are  not  set,  the  only  access  con¬ 
trols  are  those  established  by  the  network  operating  system.  See  your  DOS 
manual  or  the  appropriate  appendix  of  the  Network  Installation  manual  to 
define  access  controls  outside  of  dBASE. 

Table  5-2  summarizes  the  values  you  enter  in  this  menu  and  lists  the  default 
values  for  items  on  this  menu. 


Table  5-2  Files  menu  items  summary 


Menu  Item 

New  file 

Group  name 

Read  privilege 
Update  privilege 
Extend  privilege 
Delete  privilege 
Access  level 


Value  Type 

Menu  list 
item 

User-defined 
character  string 

Integer 

Integer 

Integer 

Integer 

Integer 


Value 

File  selected 
from  file  list 


1  through  8 
1  through  8 
1  through  8 
1  through  8 
1  through  8 

Fields  selected 
from  field  list 


FULL,  R/O, 
NONE 


Initial  Default 

The  current  drive 
designation 


8 

8 

8 

8 

1 

First  field  in  list 

FULL* 


Field  access  privilege  Enumerated 
(set  for  each  field  at  data  type 
each  access  level) 


1-8  alphanumeric  None 
characters 


*  Once  field  privileges  are  set  for  an  access  level,  the  field  privileges  for 
more  restricted  levels  that  are  not  set  default  to  FULL.  (See  the  “Establish¬ 
ing  Field  Access  Privileges”  section  below.) 
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Selecting  Database  Files 

Pressing  «-*  to  choose  the  New  file  option  displays  a  file  list.  The  file  list 
illustrated  in  Figure  5-4  contains  the  names  of  all  the  database  files  in  the 
system. 

6‘Z3:49  p«  ' 


\DB4 


<  DBSANPLES  > 
< DBTUTOR  > 

<  SQLHOME  > 

<  SOLSAMPL > 
CLIENT. DBF 


Figure  5-4  File  list 


Move  the  highlight  to  the  name  desired  and  press  «— *.  The  highlighted  file 
name  will  be  displayed  in  the  New  file  option. 


WARNING 

You  can  create  database  file  privilege  schemes  for  up  to  nine  data¬ 
base  files  at  a  time.  If  you  try  to  set  up  a  tenth  file,  you  will  get  the 
error  message  Too  many  flies  are  open.  When  you  have  finished 
creating  the  eighth  scheme,  move  to  the  Exit  menu  and  select  Save 
or  Exit  to  save  the  database  file  privilege  schemes.  If  appropriate, 
you  can  then  move  back  to  the  Files  menu  and  continue  defining 
database  file  privilege  schemes. 


Assigning  the  File  to  a  Group 

A  file  can  be  assigned  to  only  one  group.  The  group  name  will  be  matched 
with  a  user  group  name  to  enable  data  access.  Try  to  organize  users  and  files 
into  groups  that  reflect  application  use  (for  instance,  by  department  or  sales 
area).  Through  group  association  you  can  establish  file  and  user  sets  to  limit 
application  access  by  user  and,  within  applications,  to  limit  what  users  can 
do  with  applications.  (See  “The  User  and  File  Group”  section  above.) 
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Establishing  File  Privilege  Levels 

Next,  you  establish  the  privilege  levels  for  the  selected  file.  File  privileges 
specify  the  access  rights  to  a  file.  When  you  select  File  access  privileges,  the 
system  displays  the  File  access  levels  submenu  shown  in  Figure  5-5. 

Users  Flies  Reports  Exit  6>Z7‘39  pn 

Neu  file  SYSCOLS. DBF 

Group  none  PAYROLL 

File  access  privileges  *  ► 

Field  access  privileges 

Access  level  1 

Establish  field  privileges 

Store  file  privileges 
Cancel  current  entry 


Figure  5-5  File  access  levels  submenu 


These  access  rights  cannot  override  a  read-only  attribute  established  for  the 

file  at  the  operating  system  level. 

In  building  a  file  privilege  scheme,  note  that: 

■  Access  level  1  has  the  most  privilege,  and  access  level  8  has  the  least. 
Level  1  is  called  the  least  restrictive  access  level,  while  level  8  is  called 
the  most  restrictive. 

■  The  more  privileged  levels  (1,  2,  3)  are  typically  assigned  to  the  fewest 
people.  To  limit  acc  ;ss  to  your  data,  the  more  privileges  a  level  has,  the 
fewer  users  you  should  assign  to  that  level. 

File  privileges  determine  permissions  for  the  file  operations  listed  in 

Table  5-3. 


Table  5-3  File  privilege  operations 

Privilege 

Access  Granted 

DELETE 

Delete  records  from  the  database 

EXTEND 

Add  records  to  the  file 

READ 

View  the  file  contents 

UPDATE 

Edit  existing  records  in  the  file 
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For  each  type  of  file  privilege,  you  can  specify  the  most  restricted  access 
level  to  have  the  privilege.  All  levels  less  restricted  than  the  specified  one 
will  be  granted  the  file  privilege;  all  levels  more  restricted  than  the  specified 
one  will  not  be  granted  the  file  privilege.  For  example,  if  you  specify  6  as  the 
READ  privilege  level  for  the  file  Customer.dbf,  all  users  with  access  levels  of 
1  through  6  will  be  able  to  read  the  file.  However,  users  with  access  levels  of 
7  and  8  will  not  be  able  to  read  the  file. 

You  assign  and  change  file  privileges  by  entering  an  integer  value.  To  change 
the  value,  highlight  the  item,  press  «-*,  and  set  the  value,  or  use  the  f  and  | 
keys  to  change  the  value. 

Establishing  a  Field  Access  Level 

Move  the  highlight  to  Access  level  and  enter  the  access  level  for  which  you 
wish  to  define  field  access.  The  eight  file  access  levels  match  the  user- 
assigned  access  levels  (1  through  8).  Remember  that  level  1  has  the  most 
rights  and  level  8  has  the  least. 

Establishing  Field  Access  Privileges 

Finally,  you  establish  Field  Access  privileges  by  moving  the  highlight  to 
Establish  field  privileges  and  pressing  «-J,  or  by  pressing  the  first  letter  of 
the  menu  choice.  A  fields  list  appears  next  to  the  Files  menu.  You  can  estab¬ 
lish  one  of  the  field  access  privileges  listed  in  Table  5-4  for  each  field  in  the 
selected  file  at  the  selected  access  level. 


Table  5-4  Field  privilege  operations 


Privilege  Access  Granted 

FULL  View  and  modify  the  field.  This  is  the  default. 

R/O  View  the  field  only  (no  update  capability). 

NONE  No  access.  The  user  can  neither  read  nor  update  the  field,  anc 

the  field  appears  as  if  it  is  removed  from  the  database  file. 


NOTE 

File  privileges  take  precedence  over  field  privileges.  For  example,  if 
a  file  privilege  is  set  for  READ,  but  not  UPDATE,  the  only  meaningful 
field  privileges  are  R/O  and  NONE. 


You  must  restrict  file  privileges  to  protect  your  data  against  file- 
oriented  commands  like  DELETE  or  ZAP.  Restricting  field  privileges  to 
R/O  or  NONE  without  restricting  file  privileges  does  not  protect  your 
data  against  these  commands. 
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The  fields  list  contains  all  fields  defined  in  the  database  file  and  the  current 
field  access  privilege  assigned  to  them.  Initially,  all  field  access  privileges  are 
set  to  FULL.  The  procedure  to  change  the  field  privilege  is  as  follows: 

1 .  Move  the  highlight  to  the  field  for  which  privilege  is  to  be  changed. 

2.  Use  «-i  to  switch  the  preset  values  between  FULL,  R/O,  and  NONE. 

3.  When  the  appropriate  field  privilege  is  displayed,  move  to  the  next  field 
to  be  changed  by  pressing  f  or  |. 

Continue  this  process  until  all  fields  for  the  access  level  are  set  to  the  appro¬ 
priate  value,  and  then  return  to  the  Files  menu  by  pressing  ■*-. 

Continue  this  process  as  long  as  necessary  to  establish  field  privileges  for  all 
user  access  levels.  The  procedure  is  as  follows: 

■  Establish  all  the  field  access  privileges  for  one  level. 

■  Then,  move  back  to  the  Files  menu  (using  •*-).  Set  the  next  access  level, 
and  move  the  highlight  back  to  Establish  field  privileges  (by  pressing 
4-i)  to  assign  field  privileges  at  that  level. 

■  This  process  continues  until  you  have  assigned  all  necessary  field 
privileges. 

If  you  specify  a  level  and  change  field  privileges,  the  changes  you  make 
affect  that  field  only  at  that  access  level.  All  other  fields  and  access  levels 
remain  the  same. 

Storing  a  File  Privilege  Scheme 

When  you  are  satisfied  with  all  the  file  and  field  access  privilege  settings,  you 
should  select  Store  file  privileges  to  store  them.  Remember  that  after  you 
have  defined  or  modified  nine  file  privilege  schemes,  you  must  save  them 
before  you  can  continue  using  the  Files  menu.  You  can  then  do  one  of  the 
following: 

■  Begin  entering  another  file  privilege  scheme 

■  Move  to  another  menu  by  pressing  <*-  or  -► 


NOTE 

Do  not  store  file  privileges  until  you  are  completely  finished  with  the 
file  you  are  working  on. 


Cancelling  a  File  Privilege  Scheme 

At  any  time  during  the  definition  or  modification  of  a  file  privilege  scheme, 
you  can  move  to  the  last  option  on  the  menu,  Cancel  current  entry,  press 
«-J,  and  delete  the  definition  in  progress. 
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Changing  a  File  Privilege  Scheme 

When  you  select  a  file,  PROTECT  checks  to  see  if  the  file  privilege  scheme 
has  already  been  defined.  If  it  has,  the  rest  of  the  menu  items  are  completed 
with  their  current  values.  You  can  then  change  any  of  the  values.  If  the  file 
privilege  scheme  has  already  been  saved,  the  message  <  filename  >  .crp 
already  exists,  overwrite  it?  (Y/N)  is  displayed.  Press  Y  if  you  wish  to 
change  any  values.  (This  is  not  affected  by  the  status  of  SET  SAFETY.) 

Make  vour  changes.  Remember  that  you  will  need  to  store  the  changes  and, 
later,  save  them.  (See  the  “Creating  a  File  Privilege  Scheme”  section  above.) 


Printing  Security  Information 

Dbsvstem.db  is  maintained  as  an  encrypted  file.  There  is  no  way  for  you  or 
anv  other  user  to  examine  the  contents  of  that  file  once  information  is  stored 
in  it.  Therefore,  you  will  probably  want  to  keep  a  hard  copy  record  of  some 
or  all  of  the  information  contained  in  Dbsvstem.db.  For  example,  if  a  user 
forgets  a  log-in  value  (such  as  group,  log-in  name,  or  password),  you  will 
want  to  have  that  information  available. 


The  Reports  menu  illustrated  in  Figure  5-6  allows  you  to  display  or  print 
security  information  about  users  and  files. 

t - - 

Users  Files  Reports  Exit  6:28=01  pn 

User  Infomatlon 
File  Infornatlon 


Figure  5-6  Reports  menu 


The  User  Information  Report  lists  the  names  of  all  system  users,  their  pass¬ 
words,  group  names,  account  names,  and  levels. 

The  File  Information  Report  lists  the  name  of  the  selected  dBASE  file,  the 
group  to  which  the  file  is  assigned,  the  file  privileges,  the  name  of  each  field 
in  the  file,  and  the  field  privileges.  The  File  Information  Report  cannot  be 
run  on  a  file  that  has  not  been  saved. 

Selecting  the  User  Information  option  displays  a  prompt  box  with  the  mes¬ 
sage  Send  report  to  the  printer?  (Y/N). 

Entering  Y  sends  the  output  to  the  printer,  and  entering  N  displays  the  out¬ 
put  on  the  screen. 

Selecting  the  File  Information  option  first  displays  a  list  of  the  available  .crp 
files.  Select  a  file  from  the  list.  The  system  displays  the  prompt  Enter  Group 
Name:. 

Enter  the  correct  group  name  for  the  selected  database  file.  The  system  dis¬ 
plays  a  box  with  the  prompt  Send  report  to  the  printer?  (Y/N). 

Entering  Y  sends  the  output  to  the  printer,  and  entering  N  displays  the  out¬ 
put  on  the  screen. 
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Exiting  from  PROTECT 

The  Exit  menu  contains  three  options: 

■  Save 

■  Abandon 

■  Exit 

Select  Save  to  post  all  new  and  updated  user  profiles  and  file  privilege 
schemes  that  have  been  stored  during  the  current  PROTECT  session.  User 
profiles  are  saved  in  the  current  Dbsystem.db  file.  File  privilege  schemes  are 
saved  in  the  database  file  structure.  You  can  save  user  profiles  at  any  point 
during  a  PROTECT  session.  You  must  save  file  privilege  schemes  after  you 
define  or  change  eight  of  them.  Database  files  are  encrypted  when  the  file 
privilege  scheme  is  saved. 

Select  Abandon  to  cancel  all  new  and  updated  user  profiles  and  file  privi¬ 
lege  schemes  not  already  saved  during  the  current  PROTECT  session. 

Select  Exit  to  terminate  the  current  PROTECT  session.  New  and  updated 
user  profiles  and  updated  file  privilege  schemes  will  be  encrypted  and  saved, 
if  they  have  not  already  gone  through  this  process. 


Other  Considerations 

Keep  the  general  considerations  discussed  in  the  rest  of  this  chapter  in  mind 
as  you  build  and  use  a  PROTECTed  database  system. 


Data  Encryption 

Be  aware  of  the  following: 

■  When  a  database  file's  privilege  scheme  is  saved,  PROTECT  creates  an 
encrypted  version  of  the  database  file  with  a  .crp  extension.  To  enable 
security,  you  should: 

1.  Copy  the  encrypted  file  (.crp)  over  the  unencrypted  file  (.dbf)  and 
change  the  extension  to  .dbf,  as  follows: 

F  >  COPY  <  filename.crp  >  <  filename.dbf  > 

You  may  want  to  copy  the  unencrypted  file  to  a  floppy  disk  and  store 
the  floppy  disk  in  a  secure  place. 

2.  Delete  the  .crp  file,  as  follows: 

F>  ERASE  <  filename.crp  > 

3.  Rename  the  .cpt  file  so  that  it  has  a  .dpt  extension. 

■  Index  files  are  only  encrypted  when  you  REINDEX  or  create  them  with 
an  encrypted  database  file. 

■  You  can  control  when  copied  files  are  encrypted  through  the  SET 
ENCRYPTION  command. 
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■  The  time  required  to  encrypt  files  depends  on  the  size  of  your  files.  Files 
are  encrypted  when  you  select  Save  on  the  PROTECT  Exit  menu  (see 
above)  or  exit  PROTECT.  If  you  are  saving  file  privilege  schemes  of  large 
files,  it  may  take  some  time  to  exit  PROTECT. 

You  can  use  the  dBCODE  utility  to  encode  application  program  files.  (Refer 
to  Chapter  18  in  Programming  with  dBASE  IV.) 

You  control  whether  newly  created  copied  files  (that  is,  destination  files 
created  by  a  COPY  operation)  are  to  be  encrypted  through  the  SET 
ENCRYPTION  command.*  (See  the  "Using  SET  ENCRYPTION"  section.) 


Using  SET  ENCRYPTION 

Even  after  a  database  system  has  been  PROTECTed,  the  database  administra¬ 
tor  and  application  programmer  maintain  control  over  encryption  of  copied 
files. 

If  a  database  system  has  been  PROTECTed,  SET  ENCRYPTION  is  ON  by 
default.  If  you  SET  ENCRYPTION  OFF,  files  created  with  the  COPY  com¬ 
mand  will  not  be  encrypted.  Refer  to  Chapter  4  for  more  information  on  the 
SET  ENCRYPTION  command. 


General  Security  Considerations 

Security  is  only  as  good  as  its  degree  of  control  and  confidentiality.  Maintain¬ 
ing  the  integrity  of  the  security  system  is  your  first  responsibility.  Be  sure 

you  consider  the  points  below  when  establishing  your  security  system. 

1.  Decide  how  your  users  are  to  be  assigned  logins.  Are  they  to  select  their 
user  log-in  name,  password,  and  group  membership,  or  will  you  assign 
the  login?  If  they  are  to  select  values  for  the  login,  be  sure  that  they 
know  how  to  make  such  a  request,  how  long  user  names  and  passwords 
can  be,  and  what  characters  can  be  used  in  them.  Passwords  should  use 
the  full  16  characters  allowed. 

2.  Once  passwords  are  determined,  make  sure  that  you  keep  your  password 
secret  and  that  your  users  understand  the  importance  of  keeping  their 
user  log-in  names  and  passwords  secret. 

3.  If  a  user  wants  to  create  a  file  and  protect  its  contents,  make  sure  the 
user  knows  how  to  communicate  that  requirement  to  the  database 
administrator  prior  to  creating  the  file.  You  may  wish  to  use  a  form  to 
facilitate  communication  between  yourself  and  your  users,  and  also  to 
have  a  hard  copy  of  security  information.  You  cm  use  copies  of  the  secu¬ 
rity  request  form  included  at  the  end  of  this  chapter,  or  develop  your 
own.  A  filled-out  security  request  form  (Figure  5-7)  is  also  provided  for 
your  reference. 

4.  Develop  a  strategy  for  retaining  the  database  administrator  password  in  a 
secure  place  so  that  it  can  be  available  should  it  be  forgotten  or  other¬ 
wise  needed.  Make  sure  it  is  well  protected  from  unauthorized  access. 
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Enter  drive 


1 


^  Enter  path 


Server/Directory  file  in  |  D  \  DBASE 


Group  name 

A 

G 

E 

N 

T 

s 

User  name 

L 

0 

U 

1 

S 

File  name 

A 

V 

A 

L 

_ 

F 

L 

T 

Enter 

Enter 

Enter 


to  8  alphanumeric  characters 
to  8  alphanumeric  characters 
to  8  alphanumeric  characters 


File  Privileges 

Least  Restrictive 

Most  Restrictive 

Access  Level 

1 

2 

3 

4 

5 

6 

7 

8 

Extend 

X 

Delete 

X 

Read 

X 

Update 

X 

Enter  X  at  Most  Restrictive  Level 


Field  Privileges 

Type  of  Access 

Fid. 

Access  Level 

No. 

Field  Name 

1 

2 

3 

4 

5 

6 

7 

8 

i 

AFLT-NO 

F 

2 

ADEP CITY 

F 

3 

ADES CITY 

F 

4 

ADATE 

F 

5 

ADEP-TIME 

F 

6 

AARR TIME 

F 

7 

ACLASS 

F 

8 

ASEAT AVL 

F 

9 

AFARE 

F 

10 

Enter  Field  Name 


"_i  t_ 


Enter  F  for  Full,  N  for  None,  or  R  for  Read  only 


Figure  5-7  Sample  security  request  form 
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1  l£l 


Server/Directory  file  in  |  :\ 

Group  name 
User  name 
File  name 


4  Enter 
4  Enter 
4  Enter 


to  8  alphanumeric  characters 
to  8  alphanumeric  characters 
to  8  alphanumeric  characters 


File  Privileges 

Least  Restrictive 

Most  Restrictive 

Access  Level 

1 

2 

3 

4 

5 

6 

7 

8 

Extend 

Delete 

Read 

Update 

Enter  X  at  Most  Restrictive  Level 


Field  Privileges 

Fid. 

No. 

Field  Name 

Type  of  Access 

1 

2 

i 

3 

Access 

4 

Level 

5 

6 

7 

8 

i 

2 

3 

4 

5 

6 

7 

8 

9 

10 

t 


Enter  Field  Name 


U  t_ 


Enter  F  for  Full,  N  for  None,  or  R  for  Read  only 
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Network  Error 
Messages 


This  appendix  alphabetically  lists  error  messages  that  are  specific  to  the 
dBASE  LAN  environment.  Each  message  is  followed  by  a  description  of  the 
cause  of  the  error  and,  where  appropriate,  suggested  corrective  action.  If  an 
error  message  has  a  number,  it  is  shown  on  the  right  side  of  the  message. 

For  error  messages  that  may  occur  when  you  run  single-user  dBASE  IV, 
refer  to  Appendix  A  in  the  Language  Reference  manual.  For  error  messages 
that  may  occur  while  installing  or  uninstalling  dBASE  IV,  refer  to 
Appendix  A  in  the  Network  Installation  manual. 


dBASE  IV  Error  Messages 

The  following  messages  may  be  displayed  when  you  start  dBASE  IV  or  after 
you  begin  running  dBASE  IV. 


Startup  Messages 

Check  network  drive  specification 

You  entered  the  command  to  start  dBASE  IV,  but  the  dBASE  IV  and 
DBNETCTL.300  files  could  not  be  located  on  the  file  server. 

You  need  to  specify  the  correct  drive  and  directory  location  of  files,  and  set 
the  correct  DOS  PATH  command  (depending  on  the  network). 

Control  file  cannot  be  processed 

dBASE  IV  cannot  locate  the  Dbase.ctl  file  in  the  DBNETCTL.300  directory, 
or  the  file  is  damaged. 

Control  file  LOCK  failure 

An  internal  error  occurred  when  checking  the  Dbase.ctl  file. 

Load  failed 

Files  in  the  DBNETCTL.300  directory  could  not  be  read. 

Maximum  network  users  reached  (xx)  Please  try  later 

The  maximum  number  of  users  (displayed  in  parentheses)  are  already 
running  dBASE  IV. 
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Memory  allocation  error 

An  internal  error  occurred  while  DOS  was  trying  to  execute  the  Dbase.com 
program  to  start  up  dBASE  IV. 

Check  network  requirements  for  installed  memory. 

Network  drive  not  supplied 

You  did  not  specify  the  correct  network  drive  with  #DF  =  when  you 
attempted  to  start  dBASE  IV,  or  the  DBNETCTL.300  directory  files  could 
not  be  found  at  the  specified  location. 

Network  load  failure 

This  message  usually  appears  due  to  a  corrupted  dBASE  IV  or 
DBNETCTL.300  directory  file. 

Try  to  run  dBASE  IV  again.  If  you  get  the  same  message,  you  may  have  to 
uninstall  dBASE  IV  and  then  reinstall  it. 

Unauthorized  duplicate 

The  Dbase.lod  file  cannot  be  found  in  the  DBNETCTL.300  directory. 


dBASE  IV  Execution  Messages 

All  database  files  must  be  closed  before  using  PROTECT 

Close  all  databases  in  use  before  attempting  to  use  PROTECT. 

Cannot  close  database  when  transaction  is  in  process 

You  must  issue  an  END  TRANSACTION  command  or  attempt  a  ROLLBACK 

before  you  can  close  a  c  atabase  that  is  involved  in  a  transaction. 

Cannot  close  index  files  when  transaction  is  in  process 

You  must  issue  an  END  TRANSACTION  command  or  attempt  a  ROLLBACK 
before  you  can  close  index  files  involved  in  a  transaction. 

Cannot  create  transaction  register  file 

dBASE  IV  is  unable  to  open  a  transaction  log  file. 

Cannot  execute  this  command  while  transaction  is  in  process 

See  the  BEGIN  TRANSACTION  command  for  a  list  of  commands  that  are 
not  allowed  during  a  transaction. 

Cannot  nest  transactions 

Transactions  cannot  be  nested  inside  other  transactions. 

Issue  an  END  TRANSACTION  command  before  starting  a  new  transaction. 

Cannot  write  to  a  read-only  file  [ill] 

A  file  has  been  opened  for  read-only  access,  and  an  attempt  has  been  made 
to  write  to  the  file. 

Cannot  write  to  database  due  to  incomplete  transaction 

An  incomplete  transaction  has  flagged  the  database  as  in  use. 

Issue  either  an  END  TRANSACTION  or  a  ROLLBACK  command  to  clear  the 
in  use  flag  from  the  database  file. 
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Cannot  write  to  transaction  log  file 

The  required  transaction  log  file  is  not  open  or  available. 

Issue  an  END  TRANSACTION  command  to  abandon  the  transaction  you 
attempted. 

Command  is  only  valid  in  multi-user  mode 

You  can  use  a  multi-user  command  only  in  multi-user  (network)  mode. 

Database  in  use: 

You  are  attempting  to  use  a  database  that  is  in  use  by  someone  else. 

Database  encrypted  [131] 

An  attempt  has  been  made  to  open  an  encrypted  database  without  passing 
through  the  log-in  procedure. 

Place  Dbsystem.db  in  the  same  directory  as  dBASE  IV,  and  log  in. 

Duplicate  user  ID 

You  are  trying  to  use  an  existing  user  ID  name  or  number  for  another  user. 

Environment  not  correct  for  rollback 

You  are  attempting  to  do  a  recovery  when  there  is  no  BEGIN  TRANSACTION 
command  and  a  transaction  log  file  does  not  exist. 

Error  in  reading  log  file 

The  transaction  log  file  is  corrupted  or  otherwise  cannot  be  read.  A  success¬ 
ful  ROLLBACK  is  not  possible. 

Exclusive  open  of  file  is  required  [HO] 

An  attempt  has  been  made  to  issue  an  INSERT  [BLANK],  MODIFY 
STRUCTURE,  PACK,  REINDEX,  or  ZAP  command,  and  the  file  has  not  been 
opened  for  exclusive  use. 

Use  the  SET  EXCLUSIVE  ON  or  USE  <  filename  >  EXCLUSIVE  command, 
reopen  the  file,  and  then  reissue  the  command. 

File  in  use  by  another  [108] 

An  attempt  has  been  made  to  open  a  file  that  has  already  been  opened  for 
exclusive  use  by  another  user. 

Try  to  open  the  file  again  later. 

File  is  in  use  by  <  name  >  .  Retrying  lock,  press  Esc  to  cancel. 

An  attempt  has  been  made  to  open  a  file  that  is  locked  by  the  user  given 
in  <  name  >  .  This  message  appears  if  you  have  specified  SET  REPROCESS 
ON. 

File  not  In  transaction  log 

You  cannot  perform  a  ROLLBACK  on  a  file  that  was  not  recorded  in  a 
transaction  log  file. 

You  must  restore  this  file  manually  from  backup  copies. 

Invalid  printer  redirection  [124] 

The  path  to  a  printer  destination  has  not  been  established,  or  the  printer  is 
not  shareable. 

Lock  table  is  full 

The  lock  table  allows  a  maximum  of  50  locks  per  session. 

Unlock  some  records  and  continue. 
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Log  file  corrupted 

The  log  file  is  unuseable.  Recovery  is  not  possible. 

Log  file  not  found 

The  log  file  is  missing.  Recovery  is  not  possible. 

Log  record  does  not  match  database  record 

The  log  file  is  unuseable. 

Network  server  busy  [148] 

Your  file  server  cannot  process  the  number  of  tasks  requested  on  the  net¬ 
work.  This  message  indicated  that  the  server  may  not  have  executed  dBASE 
tasks  or  commands  correctly. 

You  should  quit  dBASE  IV  and  reboot  the  network.  To  correct  the  problem, 
you  need  to  reduce  network  traffic. 

Password  and  confirmation  mismatch 

When  entering  the  administrator  password,  the  confirmation  did  not  match 
the  original  password. 

Re-enter  the  password. 

Password  has  not  been  defined 

You  have  entered  an  incorrect  password. 

Try  again. 

Record  in  use  by  another  [109] 

An  attempt  has  been  made  to  read  or  lock  a  record  that  has  already  been 
locked  by  another  user. 

Try  to  access  the  record  again  later. 

Record  is  in  use  by  <  name  >  .  Retrying  lock,  press  Esc  to  cancel. 

An  attempt  has  been  made  to  open  a  record  that  is  locked  by  the  user  given 
in  <  name  >  .  This  message  appears  if  you  have  specified  SET  REPROCESS 
ON. 

Record  not  locked  [130] 

An  attempt  has  been  made  to  use  the  REPLACE  command  or  the 

@... SAY... GET  command  sequence  to  update  a  record;  the  file  has  not  been 

opened  for  exclusive  use,  and  a  lock  has  not  been  placed  on  the  record. 

Use  the  LOCK()  function  to  lock  the  record,  and  try  again. 

Relation  record  in  use  by  another 

A  record  that  is  related  to  the  record  you  want  to  access  is  in  use. 

Try  again  later. 

Rollback  database  cannot  be  executed  inside  a  transaction 

Move  the  ROLLBACK  command  after  the  END  TRANSACTION  command. 
ROLLBACK  <  database  filename  >  cannot  be  used  inside  a  transaction. 
ROLLBACK  <  database  filename  >  is  used  after  a  system  failure  for  rollback 
one  database  file  at  a  time. 

Unable  to  LOCK 

An  attempt  has  been  made  to  use  Ctrl-0  to  lock  the  current  record,  which 
has  already  been  locked  by  another  user. 

Try  to  lock  the  record  again  later. 
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Unable  to  SKIP 

An  attempt  has  been  made  to  use  Ctrl-C  or  Ctrl-R  to  skip  to  a  locked  record. 
Try  to  access  the  record  again  later. 

Unauthorized  access  level  [133] 

An  attempt  has  been  made  to  access  a  file  or  field  without  the  appropriate 
privilege. 

See  your  database  administrator. 

Unauthorized  login  [132] 

Three  attempts  have  been  made  to  log  in  to  dBASE  IV,  none  of  which  were 
successful.  dBASE  IV  will  return  you  to  the  default  network  drive  prompt. 

This  message  also  appears  if  the  user  login  you  are  using  is  already  in  use  at 
another  workstation. 

Unterminated  transaction  file  exists,  cannot  start  new  transaction 

Issue  a  ROLLBACK  command  at  this  point.  You  cannot  end  the  transaction. 
You  must  roll  it  back.  If  the  rollback  fails,  ERASE  the  Translog.log  file.  If 
there  are  two  users  logged  in  to  the  network  operating  system  with  the 
same  name,  log  out  one  of  them.  Transaction  processing  requires  that  the 
first  eight  characters  of  any  network  log-in  name  be  unique. 

**  WARNING  **  Uncompleted  transaction  found 

You  are  attempting  to  use  a  BEGIN  TRANSACTON  command  before  first 
issuing  an  END  TRANSACTION  command. 
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Access 
Access  level 


Coaxial  cable 

Collision 

Communication 

Configuration 

Data  integrity 

Data  privacy 


Database 

administrator 


Glossary 


This  glossary  includes  terms  that  are  specific  to  Networking  With 
dBASE  IV.  For  other  dBASE  IV  term  definitions,  refer  to  the  glossa¬ 
ries  in  other  dBASE  IV  manuals. 

The  ability  to  use  system  resources. 

A  number  that  determines  user  file  access  in  a  PROTECTed  data¬ 
base  system.  An  access  level  assigned  in  the  user  profile  is  matched 
against  an  access  level  in  a  file  privilege  scheme  to  determine  what 
a  user  can  do  with  a  file.  See  field  privilege  and  file  privilege. 

A  connecting  cable  that  consists  of  two  insulating  layers  and  two 
conductors. 

An  uncontrolled  attempt  by  more  than  one  user  to  update  a  data¬ 
base  at  the  same  time. 

The  act  of  sending  and  receiving  data  between  workstations. 

The  combination  of  hardware  and  software  used  in  a  network.  The 
hardware  consists  of  the  equipment  and  the  way  it  is  connected. 
The  software  consists  of  the  programs  that  operate  the  system,  the 
network,  and  applications  within  the  system. 

A  system  that  protects  database  files  against  data  loss  and  prevents 
corruption  of  index  files.  In  a  LAN  environment,  the  dBASE  IV 
locking  functions  help  ensure  data  integrity. 

The  limiting  of  access  to  information.  In  dBASE  IV,  the  PROTECT 
command  is  used  to  create  and  maintain  data  privacy.  PROTECT 
ensures  data  privacy  by  controlling  access  at  the  file  and  field  level 
through  file  and  field  privileges,  and  by  controlling  data  accessibil¬ 
ity  through  data  encryption.  See  encryption,  field  privilege,  file 
privilege,  password  protection,  and  PROTECT. 

The  person  or  persons  responsible  for  installing  and  maintaining 
dBASE  IV  on  a  local  area  network. 


Deadlock 

Decryption 

Download 


An  infinite  loop  caused  when  serial  transaction  processing  is  occur¬ 
ring  and  a  user  continuously  tries  to  gain  access  to  an  unavailable 
file. 

The  process  of  deciphering  data  from  an  encoded  form  so  that  it 
can  be  read.  See  encryption. 

To  request  and  receive  a  file  from  another  computer. 
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Encryption 

The  process  of  enciphering  or  encoding  data  so  that  it  can’t  be 
read. 

Exclusive  use 

A  file  that,  once  opened,  can  be  accessed  only  by  one  user  until  the 
file  is  closed. 

Field  privilege 

A  permission  that  establishes  what  a  user  can  do  with  a  field  in  a 
file.  In  PROTECT,  one  of  the  following  field  privileges  can  be 
assigned:  FULL,  R/O  (read  only),  NONE.  Field  privileges  are 
assigned  by  access  level. 

File  access 

The  ability  to  work  with  files.  A  network  user’s  ability  to  access 
dBASE  IV  files  is  determined  by  the  file  open  attribute,  the  file 
access  attribute,  and,  if  PROTECT  has  been  used  to  secure  a  data¬ 
base  system,  a  match  between  the  user’s  access  level  and  the  file 
privilege  scheme. 

File  access 
attribute 

A  file  status  that  determines  what  a  user  can  do  with  a  file.  The  file 
access  attributes  are  read-only  and  read/write.  If  PROTECT  is  used 
to  secure  a  database  system,  the  read/write  attribute  can  be  fine- 
tuned.  See  field  privilege  and  file  privilege. 

File  locking 

A  mechanism  for  preventing  different  users  from  gaining  simulta¬ 
neous  update  access  to  a  shared  file,  thus  ensuring  data  integrity. 

File  open  mode 

A  file  status  that  determines  how  a  file  is  opened.  If  a  file  is  opened 
for  exclusive  use,  it  can  be  used  only  by  one  user  until  it  is  closed. 

If  a  file  is  opened  for  shared  use,  it  can  be  used  by  more  than  one 
user  at  a  time. 

File  privilege 

A  permission  or  set  of  permissions  that  establishes  what  a  user  can 
do  with  an  encrypted  file.  In  PROTECT,  the  file  privileges  are 
DELETE,  EXTEND,  READ,  and  UPDATE. 

File  privilege 
scheme 

A  file  access  control  system  used  in  a  PROTECTed  database  system. 

A  file  privilege  scheme  contains  the  file  privilege  levels  and  the 
field  privilege  levels  for  a  file. 

File  server 

A  microcomputer  and  its  associated  hard  disk  on  which  the  net¬ 
work  sharing  programs  are  loaded.  The  file  server  controls  network 
communication  and  the  definition  and  sharing  of  network 
resources. 

Group 

An  organization  of  users  and  of  files  that  is  matched  to  limit  file 
access.  Groups  are  identified  by  group  name. 

LAN  environment 

A  system  or  network  of  computers  in  which  many  users  can  oper¬ 
ate  simultaneously,  sharing  network  resources. 

Local  area 
network  (LAN) 

Log-in  security 

A  collection  of  microcomputers  and  peripheral  devices  connected 
through  cables  to  communicate  and  share  resources. 

A  system  access  validation  process  that  limits  access  to  users  who 
can  provide  a  log-in  name,  password,  and  group  name. 

Network 

Any  system  that  communicates  (sends  and  receives)  data  through 
cables.  See  local  area  network. 

Network  sheil 

A  special  software  program  that  sets  up  and  manages  a  network. 
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Node 

Password 

protection 

Peripheral  devices 

Print  spooler 
Privilege 
Profile 
PROTECT 

Record  locking 

Resource 
Serial  transaction 

Shared  file 
Shell 

Transaction 


Upload 
User  profile 


Workstation 


See  workstation. 

A  method  of  limiting  log-in  access  to  a  network  by  requiring  a  user 
to  enter  a  password.  If  PROTECT  has  been  used  to  secure  a  data¬ 
base  system,  password  protection  occurs  only  if  dBASE  IV  can 
locate  the  Dbsystem.db  file  in  the  dBASE  directory. 

Printers,  plotters,  and  mass  storage  devices  connected  to 
microcomputers. 

A  buffer  in  the  file  server  that  controls  network  printing  output. 

See  field  privilege  and  file  privilege. 

See  user  profile. 

A  dBASE  IV  command  that  is  used  to  create  and  maintain 
dBASE  IV  security,  including  log-in  security,  file  access,  and  field 
access.  See  encryption,  group,  and  user  profile. 

A  software  mechanism  for  preventing  different  users  from  gaining 
simultaneous  update  access  to  the  same  record  in  a  shared  file, 
thus  ensuring  data  integrity. 

Any  computer,  device,  or  file  that  is  a  part  of  a  network. 

A  database  update  in  which  records  are  read,  modified,  and  saved 
in  a  consecutive  manner.  In  a  network  environment,  serial  transac¬ 
tions  use  record  locking  to  prevent  collision. 

A  file  that  more  than  one  user  at  a  time  can  use. 

See  network  shell. 

A  unit  of  work  that  uses  a  consistent  database,  executes  a  series  of 
updates,  and  produces  another  consistent  database.  While  the 
updates  are  being  made,  the  database  is  in  an  inconsistent  state. 

If  any  failure  occurs  during  the  updating,  the  transaction  can  be 
reversed  to  the  consistent  state  that  existed  before  the  updates 
started.  In  this  sense,  a  transaction  is  also  a  unit  of  recovery. 

To  transmit  a  file  to  another  computer. 

The  log-in  information  maintained  for  each  user  in  a  PROTECTed 
system.  The  log-in  information  consists  of  the  user's  name,  pass¬ 
word,  and  group  name,  and  is  kept  in  the  Dbsystem.db  file.  In  addi¬ 
tion,  a  full  name  can  be  maintained  as  part  of  the  user  profile.  The 
full  name  is  not  used  as  part  of  the  log-in  information. 

An  individual  personal  computer  connected  to  another  within  a 
network  by  a  communications  card  and  a  cable. 
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This  section  explains  the  meaning  and  usage  of  special 
terms,  abbreviations,  and  symbols  used  in  the  syntax  para¬ 
digms  of  dBASE  IV  commands  and  functions. 


Square  brackej^indicate  an  optional  item,  keyword,  or 
clause  in  a  command  or  function.  Do  not  enter  the  square 
brackets  in  the  command  line 

Do  not  confuse  square  brackets,  meaning  an  optional  item, 
with  square  brackets  used  as  a  character  delimiter. 


-3* 


JS 

A 


juAfes/tfcej 


Ellipsis  indicates  that  you  may  specify  one  or  more 
elements  of  the  type  listed. 

/ 

A  forward  slash  indicates  you  can  use  one  option  or  the 
other,  but  not  both.  If  there  are  many  options,  you  can  use 
only  one. 


<  > 

Angle  brackets  indicate  you  must  substitute  an  item  of  the 
type  requested  inside  the  brackets.  Do  not  enter  the  angle 
brackets  in  the  command  line. 

? 

The  ?  is  also  called  the  query  clause.  If  you  enter  the  ?  in 
place  of  a  filename,  dBASE  IV  prompts  you  to  choose  a  file 
from  the  current  catalog,  if  a  catalog  is  open,  or  from  a  list 
of  files  on  disk,  if  a  catalog  is  not  open. 

Do  not  confuse  the  ?  query  clause  with  the  ?  command,  or 
with  the  ?  wildcard  character  of  a  skeleton. 

See  skeleton. 
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alias 

An  abbreviation  which  you  can  use  in  place  of  a  database 
filename  to  reference  a  work  area.  You  may  have  up  to  ten 
database  files  open  simultaneously  in  dBASE  IV.  Each  file  is 
open  iJTa  different  work  area.  With  many  commands,  you 
may  reference  a  work  area  by  using  the  filename  of  the 
database  that  is  open  in  the  work  area  or  by  using  a  letter 
from  A  to  J.  The  SELECT  command  allows  you  to  use  a 
number  from  1  to  10. 

See  alias  nameST 

alias  name 

An  alternate  name  for  a  database  file  that  is  established  with 
the  ALIAS  option  of  the  USE  command.  If  you  do  not  use 
the  ALIAS  clause,  the  alias  name  is  the  same  as  the  database 
filename.^ 

Commands  that  have  an  IN  clause  will  only  accept  an  alias 
name,  not  an  alias.  Alias  names  may  be  up  to  ten  characters 
long,  and  may  contain  embedded  underscores. 

application 

Acustomized  program  written  in  the  dBASE  programming 
language. 

array 

A  structure  containing  a  group  of  items,  called  elements, 
stored  in  RAM.  Each  element  may  contain  data,  and  each 
can  be  identified  by  it*s*position  in  the  array. 

array  element 

One  variable,  or  data  item,  contained  in  an  array.  Each  ele¬ 
ment  can  be  referred  to  by  its  unique  name,  which  is  com¬ 
posed  of  the  array  name  and  the  element’s  position  within 
the  array. 

attribute 

The  color,  intensity,  or  blinking  of  a  region  on  the  screen, 
or  a  code  used  to  represent  the».  You  use  these  codes  in 
certain  commands  to  control  the  screen’s  colors  and  inten¬ 
sity,  or  to  make  characters  or  regions  of  the  screen  blink. 

background 

The  attributes  of  a  screen  region  against  which  the 
foreground  characters  display. 

See  attribute,  forefiTmiaJ^* 

' — — — 

binary  file 

An  assembly  language  program  that  can  be  loaded  into 
memory  and  called  from  within  dBASE  IV.  Usually,  the 
assembly  program  performs  special  tasks  that  dBASE  can¬ 
not.  The  assembly  program  may  return  values  that  dBASE 
can  subsequently  process. 


*n 

* 


Sf/V$BeT^\ 


M 


1-2 


PARADIGM  TERMS  AND  SYMBOLS 


IGE:  3  SESS:  A  Ued  Jun  1  14: 38:  A7  1988 
a  I  l  j  obz/CLS_rnanhat/GRP_manhat/JOB_manqu  i  kref /DIV_qrchapl 


border  definition  string 

A  list  of  characters  or  ASCII  decimal  codes  that  define  the 
borders  of  boxes,  windows,  and  lines.  If  you  specify  the 
ASCII  decimal  codes,  do  not  use  character  string  delimiters. 


col 

A  horizontal  screen  coordinate,  numbered  from  the  left  of 
the  screen  to  the  right.  In  graphic  mode,  the  coordinate  at 
the  far  left  of  the  screen  is  column  0.  In  text  mode,  the 
coordinate  on  the  far  left  of  the  screen  is  column  1.  Most 
monitors  display  80  columns  across  the  screen,  although 
some  can  display  more. 

columns 

An  array  element’s  x-axis  coordinates.  The  data  in  each 
array  can  be  viewed  as  a  two-dimensional  matrix  containing 
rows  and  columns.  An  element  is  referenced  by  its  row  and 
column  position. 


condition 

An  expression  that  evaluates  to  a  logical  true  (.T.)  or  false 

(F.). 

■a 

delimiter 

A  character  that  bounds  a  string.  Delimiters  notify 
dBASE  IV  that  the  text  enclosed  between  the  delimiters 
should  be  treated  as  a  character  string. 

element 

See  arrgv  element. 


enhanced 

The  foreground  and  background  attributes  of  certain  com¬ 
mands  that  output  to  the  screen,  such  as  EDIT.  Usually,  the 
output  of  commands  that  allow  you  to  modify  data  is  in 
enhanced  (also  called  taverse )  video. 

See  attribute,  bgckgrpniul,  .foreground,  §tan_dard. 

expC 

An  expression  that  evaluates  to  a  character  string. 

A 

expN 

An  expression  that  evaluates  to  a  number. 

expression 

Any  combination  of  data  from  fields,  memory  variables, 
elements,  or  constants,  joined  by  operators  or  functions, 
that  evaluates  to  one  data  type.  Expressions  may  evaluate  to 
character,  date,  logical,  or  numeric  type. 


cST) 


'  n 

S\ 
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field 

One  variable,  or  item  of  information,  contained  in  a  record 
of  a  database  file. 

file  type 

A  keyword  indicating  the  format  of  an  input  or  output  file. 
File  types  are: 

■  dBASEII  -  dBASE  II  database  file 

3 

m  DELIMITED  —  Variable  length  ASCII  text  file  with 
character  fields  enclosed  within  double  quotes  (" ) 

■  DELIMITED  WITH  BLANK  -  Variable  length  ASCII 
text  file  with  no  delimiters  enclosing  character  fields 

■  DELIMITED  WITH*—  Variable  length  ASCII  text  file 
with  character  fields  enclosed  by  the  specified  delimiter 

■  DIF  -  Visicalc  DIF  file 

■  FW2  —  Framework  II  database  file  (sometimes,  a 
Framework  spreadsheet  file) 

■  RPD  —  RapidFile  data  file 

■  SDF  —  System  Data  Format  file  (ASCII  text  file) 

■  SYLK—  Multijslan  spreadsheet  file 

■  WKS  —  Lotus  spreadsheet  file,  Release  1A 

■  WK1  —  Lotus  1^  spreadsheet  file,  Release  2.x 


filename 

A  valid  DOS  filename,  or  an  indirect  file  reference.  Chapter 
1,  “Essentials,”  of'"*Canguage  ReferenceJ>^fc3iscusses  indirect 
file  references. 


flows 

A  series  of  signed  periodic  cash  flows. 


frame  " 

The  border,  or  frame,  of  a  window. 

{{Note  to  Tech  Reviewers:  Is  the  term  frame  used  in  any 
paradigm?  The  full  list  is  not  available  at  this  writing,  but  I 
think  the  term  is  no  longer  used.  :Mike}} 


foreground 

The  attributes  of  characters  that  display  against  the  back¬ 
ground  regions  of  a  screen^ 

See  attribute,  backg.to_un (T<^- 


<aeliwrkr> 

A 


(5^) 


a/a 

a/a 
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function 

One  of  a  set  of  formatting  rules  that  apply  to  all  characters 
of  data  displayed  by  either  the  SAY  option  oriGET  option  of 
the  @  command. 

The  functions  are!A$(ABCDEHIJLMRS,TVX 
and 

O 

^"number  or  date  that  you  stipulate  as  the  highest  (or,  for 
a  date,  the  latest)  entry  allowable  by  a  user. 

initial 

The  value  of  the  initial  investment. 

key  expression 

A  special  type  of  expression  used  to  build  an  index.  The 
expression  must  not  exceed  220  characters,  and  must  evalu 
ate  to  one  data  type.  The  evaluated  expression  must  not  be 
longer  than  100  characters. 


key  field 

An  INDEX  or  SORT  key  composed  of  one  field  only. 


keyword 

Aword  used  in  the  dBASE  IV  language  as  part  of  a  com¬ 
mand,  function,  system  memory  variable,  or  Config.db  file  - 

setting.  Keywords  are  shown  in  all  uppercase  letters.  A 


,ist  ^ 

A  group  of  like  items  (such  as  fieldy^xpressions/Ytem  plates^) 

separated  by  commas.  ^ - - - 

or 

literal  key 

A  constant  that  may  be  a  key  in  an  index. 

A 

A} ^number  or  date  that  you  stipulate  as  the  lowest  (or,  for  a 
date,  the  earliest)  entry  allowable  by  a  user. 


(Sf~  T 


/oak-  -fo 
a 

/oak  ~  /#» 

A 


.mdx  file 

A  multiple  index  file,  which  may  contain  up  to  47  tags. 

Each  .mdx  file  is  associated  with  a  database  file.  Each  tag  in 
the  .mdx  file  may  impose  an  index  order  on  the  database 
file.  When  you  open  an  .mdx  file,  you  have  access  to  all  tags 
contained  in  the  file. 

memo  field 

Variable-length  fields  used  to  hold  large  blocks  of  text  such 
as  memos  and  short  documents.  Memo  field  data  is  not 
written  in  the  database  (.dbf)  file,  but  in  a  separate  .dbt  file 
associated  with  the  .dbf  file. 
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memory  variable 

Avariable,  or  data  item,  stored  in  RAM,  but  not  part  of  a 
database  unless  you  specifically  write  it  to  a  file. 

memvar 

An  abbreviation  for  “m emory  variable.” 

menu 

A  menu,  or  list  of  choices,  defined  with  the  DEFINE  MENU 
command. 

n 

A  literal  positive  integer. 

.ndx  file 

An  index  file.  Each  .ndx  file  may  impose  an  index  order  on 
the  database  file,  and  is  similar  to  a  tag  contained  in  an 
.mdx  file. 

parameter 

A  value  supplied  to  a  program  or  procedure. 

path 

The  path  of  directories  and  subdirectories  that  should  be 
searched  for  files. 

erimeter 

he  square  region  composed  of  the(fap)top,  bottom,  left, 
nd  right  of  the  screen,  against  whicTTcharacters  (the  fore¬ 
round)  cannot  be  displayed.  The  perimeter  frames  the 
screen’s  display  area. 


POP U£ 

Apopjjp  menu  defined  with  the  DEFINE  POPUP  command. 
You  may  define  it  to  “pop  up”  anywhere  on  the  screen. 


print  column 

A  horizontal  coordinate  on  the  printed  page,  from  the  left  of 
the  page  to  the  right. 

print  line 

The  number  of  a  line  on  the  printed  page,  counting  from 
the  top  of  the  page. 

prompt 

Acharacter  expression  you  provide  that  shows  up  on  the 
screen  and  prompts  the  user  for  input. 

rate 

A  discount  rate,  which  is  an  interest  rate  usually  expressed 
as  a  percent. 
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record  number 

Each  record  in  a  database  file  has  an  associated  record 
number.  The  first  record  in  the  file  is  record  1.  Record 
numbers  are  reassigned  if  you  DELETE  and  PACK  some 
records,  or  INSERT  records  into  a  database  file. 

•a  e  # p 

row  ^ 

Avertical  screen  coordinate,  numbered  from  the  top  of  the 
screen  to  the  bottom.  The  coordinate  at  the  top  of  the 
screen  is  row  0. 


rows 

An  array  element’s  y-axis  coordinates.  The  data  in  each 
array  can  be  viewed  as  containing  rows  and  columns.  An 
element  is  referencejftjy  its  row  and  column  position. 


The  range  of  records  in  a  database  file  that  you  direct  a 
command  to  process. 

Valid  ranges  areT^ 

■  ALL  —  All  the  records  in  the  database  file 

■  NEXT/\—  The  next^records  in  the  file,  beginning  with 
the  current  record 

■  RECORD^—  One  record  whose  record  number  is  ^ 

■  REST  —  The  rest  of  the  records  in  the  database  file, 
from  the  current  record  to  the  end  of  the  file 

skeleton 

A  pattern  of  letters  and  wildcard  symbols  that  a  file  or  vari 
able  name  must  match.  The  two  wildcard  symbols  are  ?, 
which  indicates  any  one  character,  and  *,  which  indicates 
any  contiguous  combination  of  characters. 


:<J 


<e/p/\j>  J <exp/V> 

A  A 


standard 

The  foreground  and  background  attributes  of  most  com¬ 
mands  that  output  to  the  screen,  such  as  the  ?  command. 
Usually,  the  output  of  commands  that  display  data  on  the 
screen,  butifo  not  allow  you  to  modify  that  data,  is  vnfstan 
dard  video. A 

See  attribute,  background,  enhainied,  foreground. 

structure  extended  file 

A  database  file  created  with  the  COPY  STRUCTURE 
EXTENDED  command. 


tag 

An  index  contained  in  a  multiple  index  (.mdx)  file.  An  .mdx 
file  may  contain  up  to  47  tags,  each  of  which  may  impose 
an  index  order  on  the  database  file. 
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template 

One  of  a  set  of  formatting  symbols  used  with  the  PICTURE 
keyword.  These  symbols  apply  to  single  characters  of  data 
displayed  by  either  the  SAY  option  or*GET  option  of  the  @ 
command.  ^ 

The  templates  are  9  #  A  L  Y  N  X  !  $  *  .  and  ,  g- 
variable 

A  data  item,  which  may  be  a  memory  variable,  field,  array 
element,  or  expression. 

window 

A  window  defined  with  the  DEFINE  WINDOW  command  to 
have  special  border  and  screen  attributes. 

work  area  number 

A  number  from  1  to  10  that  represents  one  of  the  ten 
work  areas.  You  may  have  one  database  file  open  in  each 
work  area,  and  thereby  have  ten  database  files  open 
simultaneously. 
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Commands 


These  are  covered  in  detail  in  Chapter  2  of  Language 
Reference. 

?/??  [<  expression  1  >  [PICTURE  *  <  clause >  ']  Ls 

[FUNCTION^  function  list>  ']  [AT  <  expN>  ]  MM 

[STYLE  <  font  number  >  ]] 

[,  <  expression  2  >  ...] 

Displays  the  value  of  one  or  more  expressions.  ?/??  roughly 
translates  to:  “What  is  .  .  .  ?”  or  “What  is  the  value  of  .  .  .  ?”  | 

or,  simply,  “Print  .  .  ^ 

???  [<  expC>  ] 

Sends  output  directly  to  the  printer,  bypassing  the  installed 
printer  driver. 


@  <  row  >  ,  <  col> 

[  [SAY  <  expression  >  , 

[PICTURE  <  clause  >  ]  [FUNCTION '<  function  list>‘[] 
rGET  <  variable  >  [[OPEN1  WINDOW? 

C<  window  name  >  ] 

[PICTURE  <  clause  >  ]  [FUNCTION ‘<  function  list^‘] 
[RANGE  <  low>  ,<  high>  ]  [VALID  <  condition  >  ] 
[ERROR  <  expC>  ][ 

[WHEN  <  condition  >  ]  [DEFAULT  <  expression  >  ] 
[MESSAGE  <  expC>  [ 

[COLOR  [<  standard >  ]  [,<  enhanced >  ]]  ] 

Used  to  create  custom  forms  for  data  input  and  output.  It 
displays  information  in  a  specified  format  at  a  given  set  of 
coordinates. 

@  <  rowl  >  ,<  coll  >  [[CLEAR]  TO  <  row2>  ,<  col2>  ] 

Clears  a  portion  of  the  screen. 

@  </row1  >  ,<  coll  >  FILL  TO  <  row2>  ,<  col2> 
J[COLOR/[<  color  attribute  >  ] 

Allows  you  to  change  the  colors  tff  a  specific  rectangular 
region  on  your  screen. 


'*  /  " 
A  l  \  • 


5/ 


A 


or 

A 


A 
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@  <  rowl  >  ,<  colt  >  TO  <  row2>  ,<  col2> 

[DOUBLE/PANEL/NONE/ <  border  definition  string  >  ] 

[COLOR^  color  attribute  >  ] 

Draws  a  box  on  the  screen  with  single  lines,  double  lines, 
or  specified  characters.  It  can  also  remove  a  box  from  the 

screen. 

> 

ACCEPT  [<  prompt>  ]  TO  <  memvar> 

Used  primarily  in  command  files  to  prompt  a  user  for  key¬ 
board  entry.  It  creates  a  character  memory  variable  in 
which  it  stores  the  keyboard  entry.  Terminate  data  entry 
with  •*-*•. 

A 

ACTIVATE  MENU  <  menu  name>  [PAD  <  pad  name  >  ] 

Activates  an  existing  bar  menu  and  displays  it  for  use. 

ct 

ACTIVATE  POPUP  <  popup  name  > 

Activates  a  previously  defined  pop-up^for  use. 

ACTIVATE  SCREEN 

Sends  screen  output  from  the  active  window  to  the  entire 

CRT  screen,  covering  up  any  displayed  windows  without 
erasing  them  from  the  screen. 

M^q 

A 

ACTIVATE  WINDOW  <  window  name  list>  /ALL 

Activates  and  displays  a  defined  window  from  memory  and 
directs  all  screen  output  to  that  window. 

APPEND  [BLANK] 

Allows  you  to  add  new  records  to  the  end  of  the  active] data- 
base  file. 

X- 

APPEND  FROM  <  filename  >  /? 

[[TYPE]  <  file  type>  ]  [FOR  <  condition  >  ] 

Copies  records  from  an  existing  file  to  the  end  of  the  active 
database  file.  The  FROM  file  does  not  have  to  be  a 
dBASE  IV  file. 

APPEND  FROM  ARRAY  <  array  name  >  FOR  <  condition  > 

Adds  records  to  a  database  file  from  information  in  an 
array. 

APPEND  MEMO  <  memo  field  name>  FROM  <  filename  > 
[OVERWRITE] 

Imports  a  file  into  a  named  memo  field. 

ASSIST 

Gives  you  access  to  dBASE  IV’s  Control  Center. 
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/AVERAGE  [<  expN  list>  ]  [<  scope  >  ] 

[FOR  <  condition  >  ] [WHILE  <  condition  >  ] 

[TO  <  memvar  list >  /TO  ARRAY  <  array  name  >  ] 

Computes  the  arithmetic  mean  of  numeric  expressions. 


BEGIN  TRANSACTION  [<  path  name>  ] 

and  when  the  transaction  is  complete  and  satisfactory?^ 

Qend  transaction 

ts  a  transaction  and  records  changes  made  to  a  database 
file,  and  provides  the  option  to  ROLLBACK  those  changes. 
The  second  phase  of  the  command  commits  the  changes 
and  removes  the  option  to  ROLLBACK. 


BROWSE  [NOINIT]  [NOFOLLOW]  [NOAPPEND]  [NOMENU] 
[NOEDIT]  [NODELETE]  [NOCLEAR]  [COMPRESS]/[FOR- 
MAT]  [LOCK  <  expN>  ]  *— 

[WIDTH  <  expN>  ]  [FREEZE  <  field  name>  ] 
[WINDOW  <  window  name  >  ]  ^ 

[FIELDS  <  field  name  1  >  f/R]  [/<  column  width  >  ]// ) 

i  1  >  =  <  expression  1 


<»<  calculated  field  name  1 


[,<  field  name  2>  f/R]  [/<  column  width  >  \fT) 

£<  calculated  fieldAi>  >  =  <  expression  ii >  jTT.] 

A  full-screen,  menu-assisted  command  for  editing  and 
appending  records  in  database  (.dbf)  files  and  views. 


(£ove 


CALCULATE  [scope]  <  option  list  > 

[FOR  <  condition  >  ]  [WHILE  <  condition  >  ] 

[TO  <  memvar  list >  /TO  ARRAY  <  array  name >  ]  . _ 

Computes  financial  and  statistical  functions  with  your  aata. 

CALL  <  module  name>  [WITH  <  variable  >  ] 

Allows  you  to  call  binary  file  program  modules  loaded  in 
memory.  You  must  have  first  loaded  the  binary  program 
files  in  memory  using  the  LOAD  command. 


£  j-/OA/ 


CANCEL 

Stops  the  execution  of  a  command  file,  closes  all  open 
command  files,  and  returns  dBASE  IV  to  the  dot  prompt. 
CANCEL  does  not  close  procedure  files. 

CHANGE  [NOINIT]  [NOFOLLOW]  [NOAPPEND]  [NOMENU] 
[NOEDIT]  [NODELETE]  [NOCLEAR] 

[<  record  number  >  ]  [FIELDS  <  field  list  >  ] 

[<  scope  >  ]  [FOR  <  condition  >  ] 

[WHILE  <  condition  >  ] 

An  alternate  syntax  for  EDIT,  which  is  a  full-screen  com¬ 
mand  you  use  to  display  or  change  the  contents  of  a  record 
in  the  active  database  file  or  view. 
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where  C< option  list>)  can  be  any  one  of  the  following  functions: 


AVG (<expN>) 

CNT  ( ) 

MAX (<expN>) 

MIN (<exp>) 

NPV ( <rate> , <f lows> , <initial>) 
STD(<expN>) 

SUM(<expN>) 

VAR(<expN>) 
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CLEAR  [ALL/FIELDS/GETS/MEMORY/MENUS/POPUPS/ 
TYPEAHEAD/WINDCWS] 

Erases  the  screen,  repositions  the  cursor  to  the  lower  left- 
hand  corner  of  the  screen,  and  releases  all  pending  GETs 
created  with  the  @  command. 

^CLOSE  ALL/ALTER NATE/PATABASES/FORMAT/  'l 

- ^DEPROCEDURE 

Used  to  close  alternate  files,  database  files,  format  files, 
index  (.ndx  and  .mdx)  files,  memo  files,  and  procedure  files. 

COMPILE  * 

Reads  a  file  containing  dBASE  IV  source  code,  and  creates 
an  executable  object  code  file. 

CONTINUE 

Searches  for  the  next  record  in  the  active  database  file  that 
meets  the  condition  specified  by  the  most  recent  LOCATE 
com  mand. 

CONVERT  [TO  <  expN>  ] 

Adds  a  field  to  a  database  file’s  structure  which  holds  infor¬ 
mation  required  for  multi-user  lock  detection. 

COPY  TO  <  filename  > 

Duplicates  all  or  part  of  an  active  database  file,  creating  a 
new  file.  COPY  is  also  the  primary  command  used  to  export 
data  to  non-dBASE  programs. 

COPY  FILE  <  filename  >  TO  <  filename  > 

Creates  a  duplicate  of  any  file. 

COPY  INDEXES  <  .ndx  file  list>  [TO  <  .mdx  filename  >  ] 

Converts  index  (.ndx)  files  into  multiple  index  (.mdx) 
file  tags. 

COPY  MEMO  <  memo  field  name>  TO  <  filename  > 
JAgDITIVE] 

Copies  the  information  from  a  single  memo  field  to  another 
file. 

COPY  STRUCTURE  TO  <  filename  >  [FIELDS  <  field  list>  ] 

Copies  the  structure  of  the  active  database  file  to  a  new  file, 
but  does  not  copy  any  records. 

COPY  TO  <  filename  >  STRUCTURE  EXTENDED 

Creates  a  new  database  file  whose  records  contain  the 
structure  of  the  current  file. 


A 


2-4 


COMMANDS 


JOBNAME:  PAGE:  5  SESS:  3  Ued  Jun  1  18:45:14  1988 

@tate/d  i  sk2/a  I  l  j  obz/CLS_manhat/GRP_manhat/JOB_manqu  i  kref  /DI  V_qrchap2 


COPY  TAG  <  tag  name>  [OF  .mdx  filename]  TO 
<  .ndx  filename  > 

Converts  multiple  index  (.mdx)  file  tags  into  index 
(.ndx)  files. 


COPY  TO  ARRAY  <  array  name>  [FIELDS  <  fields  list  >  1 


rr  <  sto 


pe>  |  |hUK  <  condition  >  |  |  WHILE  <  condition  > 

;Jan  existing  array  with  the  contents  ot'one  or  more 

records  from  the  active  database  file. 


COUNT  [TO  <  memvar>  ] 

[<  scope  >  ]  [FOR  <  condition  >  ]1[WHILE  _ 

<  condition  >  ]  —  Z— 

Tallies  the  number  of  records  in  the  active  database  file  that 
match  specified  conditions. 


CREATE  <  filename  >  /MODIFY  STRUCTURE 

Gives  you  access  to  the  database  file  design  screen.  CREATE 
allows  you  to  build  a  structure  for  a  new  database  file. 
MODIFY  STRUCTURE  allows  you  to  modify  the  structure  of 
a  previously^created  database  file.  Both  commands  provide 
the  same  screen  for  designing  the  file  structure. 


CREATE/MODIFY  APPLICATION  <  filename  >  /? 

Gives  you  access  to  the  dBASE  IV  Applications  Generator, 
which  generates  the  code  needed  to  tie  objects^such  as^ 
database  files,  index  files,  queries,  reports,  forms,  menus, 
and  lists, (together) in  one  application. _ _ 


CREATE  <  filename  >  FROM  <  extended  structure  file  > 

Forms  a  new  database  file  from  the  structure  created  with 
the  COPY  STRUCTURE  EXTENDED  command. 


(Zove j 


CREATE/MODIFY  LABEL  <  filename  >  /? 

Gives  you  access  to  the  label  designer.  The  label  designer 
allows  you  to  create  label  form  (.lbl)  files  using  the  fields 
specified  in  the  current  database  file  or  in  other  related 
database  files. 

CREATE/MODIFY  QUERY  <  filename  >  /? 

Gives  you  access  to  the  queries  design  screen,  which  allows 
you  to  create  query  (.qbe)  files  that  extract  records  match¬ 
ing  specified  conditions,  or  to  create  update  query  (.upd) 
files  that  can  modify  records  in  the  database  file. 

CREATE/MODIFY  REPORT  <  filename  >  /? 

Gives  you  access  to  the  report  designer,  which  allows  you  to 
create  report  form  (.frm)  files  using  the  fields  specified  in 
the  current  database  file  or  in  other  related  database  files. 


QUICK  REFERENCE 


2-5 


E:  PAGE:  G  SESS:  3  Ued  Jun  1  18:45:14  1988 

di  sk2/a  I  I  jobz/CLS_manhat/GRP_manhat/JOB_jnanqu  i  kref /DI V_qrchap2 


CREATE/MODIFY  SCREEN  <  filename  >  /? 

Gives  you  access  to  the  forms  design  screen,  which  allows 
you  to  create  custom  screen  forms.  These  screen  forms 
determine  the  way  fields  and  other  data  appear  on  the 
screen  when  you  use  a  full-screen  editing  command,  such 
as  EDIT  or  APPEND. 

CREATE  VIEW  <  .vue  filename  >  FROM  ENVIRONMENT 

Builds  a  view  (.vue)  file  that  is  compatible  with 
dBASE  III  PLUS. 

DEACTIVATE  MENU 

Deactivates  the  active  bar  menu  and  erases  it  from  the 
screen  while  leaving  it  in  memory. 

DEACTIVATE  POPUP 

Erases  the  active  pop-up  menu  from  the  screen  while  leav¬ 
ing  it  intact  in  memory. 

DEACTIVATE  WINDOW  <  window  name  list>  /ALL 

Deactivates  specified  windows  and  removes  them  from  the 
screen,  without  releasing  them  from  memory. 

DEBUG  <  filename  >  /<  procedure  name  >1  [WITH  "2- 

<  parameter  list  >  ]  U-  * — J 

Gives  you  access  to  the  dBASE  IV  program  debugger. 


DECLARE  <  array  name  1  >  [<  number  of  rows> 

'  <  number  of  columns  >  ^ 

array  name  2/ number  of  rows^  <C 

__  „  this  paraaiqm,  the  cUriv  praces^  indicate  optional  items)  A 

The  square  brackets  are  a  required  part  of  the  DECLARE 

command  syntax.) 


UCULHI 

L‘" 

CJD5 


Creates  one-  or  two-dimensional  arrays  of  memory 
variables. 


DEFINE  BAR  <  line  number  >  OF  <  popup  name>  _ 

PROMPT  <  expC>  [MESSAGE^  expC>  ] 

[SKIP  [FOR  <  condition  >  ]  [NOSPACEJl 

Defines  a  single  option  in  a  pop-up  menu. 


DEFINE  BOX  FROM  <  print  column  >  TO  <  print  column  > 
HEIGHT  <  exp>  [AT  LINE  <  print  line>  ] 
[SINGLE/DOUBLE/ <  border  definition  string  >  ] 

Defines  a  box  to  be  printed  around  lines  of  text. 


DEFINE  MENU  <  menu  name>  [MESSAGE  <  expC>  ] 

Used  in  conjunction  with  the  DEFINE  PAD  command  to 
define  a  menu. 
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DEFINE  PAD  <  pad  name  >  OF  <  menu  name  ^PROMPT 

<  expC>  [AT  <  row>  ,<  col>  j7[MESSAGE 

<  expC>  ]  ■*— 

Used  to  define  a  single  pad  in  a  bar  menu. 


DEFINE  POPUP  <  popup  name  > 

FROM  <  rowl  >  <  coll  >  [TO  <  row2>  <  col2>  ] 
[PROMPT  FIELD  <  field  name  ^1/PROMPT  FILES 
dfLIKE  .")<  skeleton  >  tl) 

PROMPT  SThTJcrUR^nMESSAGE  <  expC>  ] 
Defines  a  pop-up  window’s  name,  location,  border, 
prompts,  and  message  line. 


DEFINE  WINDOW  <  window  name> 

FROM  <  rowl  >  ,<  coll  >  TO  <  row2>  ,<  col2> 
[DOUBLE/PANEL/NONE/ <  border  definition  string  >  ] 
[COLOR  [<  standard  >  ]  [,<  enhanced  >  ]  [,<  frame  >  ]] 

Defines  windows,  including  the  borders  and  screen  colors. 

DELETE  [<  scope  >  ]  [FOR  <  condition  >  ] 

[WHILE  <  condition  >  ] 

Marks  records  in  the  active  database  file  for  deletion. 


DELETE  TAG  <  tag  name  1  > 

40f  <  .mdx  filename  >  .ndx  filename  1  > 

[, <  tag  name  2 >  [OF  <Tmdx  filename >  ]/ 

<  .ndx  filename  2>  ...] 

Deletes  the  indicated  tags  from  a  multiple  index  (.mdx)  file 
if  tag  names  are  specified,  and  closes  index  (.ndx)  files  if 
index  file  names  are  specified. 


DIRECTORY/DIR  [[ON]  <  drive>  :]][[LIKE]  <  path>  ] 

[<  skeleton  >  ]  L- 

Displays  directory  information  similar  to  that  displayed  by 
the  DOS  DIR  command. 


Ce^T-^/T. 


T. 


DO  <  program  filename  >  /<  procedure  name> 

[WITH  <  parameter  list  >  ] 

Executes  a  dBASE  command  file  or  procedure.  If  the  com¬ 
mand  file  or  procedure  file  has  not  been  COMPILEd,  it  is 
first  parsed  and  saved  as  an  object  file  with  a  .dbo  exten¬ 
sion;  then,  the  .dbo  file  is  executed. 
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DO  CASE 

SE  <  condition  > 

Jjmmands  > 

|VSE  <  condition  > 

_pmmands>  ] 

Itherwise 

_ gjmmands  >  ] 

r^FN5CASE‘ 

Asiructured  programming  command  that  selects  only  one 
course  of  action  from  a  set  of  alternatives. 

DO  WHILE  <  condition  > 

^“Zjc^mmands  > 

IlcJop] 

- 

^structured  programming  command  that  allows  command 
statements  between  DO  and  the  associated  ENDDO  to  be 
repeated  as  long  as  the  specified  condition  is  true. 


EDIT  [NOINIT]  [NOFOLLOW]  [NOAPPEND]  [NOMENU] 
[NOEDFTl  [NQDELETE]  3 

^[nOCLLah]  1  [  <  record  number  >  ]  [FIELDS  <  field 
list  >  ]  ^ 

[<  scope >  ]  [FOR  <  condition >  ]} [WHILE 
<  condition  >  ]  ' — 

A  full-screen  command  to  display  or  change  the  contents  of 
a  record  in  the  active  database  file  or  view. 


EJECT 

Causes  the  printer  to  advance  the  paper  to  the  top  of  the 
next  page. 

EJECT  PAGE 

Advances  the  current  page  in  a  printer  and  stops  at  the  top 
line  of  the  next  page.  Unlike  the  EJECT  command,  which 
only  affects  the  printer,  the  output  of  EJECT  PAGE  goes  to 
any  destination  that  is  currently  available  to  the  ? 
command. 


ERASE  <  filename  >  /? 


<oT) 


[^DELETE  FILE  <  filename  >  /? 

Erases  a  file  from  the  disk  directory. 


EXPORT  TO  <  filename  >  [TYPE]  PFS/DBASE  II/FW2/RPD 
FIELDS  <  field  list  >  ]  [<  scope  >  ] 

[FOR  <  condition  >  ]  [WHILE  <  condition  >  ] 

Copies  the  open  database  file  to  a  file  format  usable  by 
PFS:FILE  ®,  dBASE  II,  Framework  II,  or  RapidFile. 


f  TvPesetrei?: 

I  dMOCio  s/e 


~L. 


~L 
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FIND  <  literal  key> 

Searches  an  indexed  database  file  for  the  first  record  with 
an  index  key  that  matches  the  specified  character  string  or 
number.  FIND  conducts  a  very  rapid  record  search. 

FUNCTION  <  procedure  name  > 

Identifies  a  procedure  associated  with  a  user-defined 
function. 

GO/GOTO  BOTTOM/TOP  [IN  <  alias  name>  ] 

Positions  the  record  pointer  to  a  specified  record  in  the 
active  database  file. 

HELP  [<  dBASE  IV  keyword  >  ] 

A  menu-driven  command  that  provides  information  about 
dBASE  IV. 

IF  <  condition  > 

<  commands  > 


[ELSE 


<  commands  >  ] 
ENDIF 


ATtructured  programming  command  that  enables  condi¬ 
tional  processing  of  commands  within  the  structure.  The  IF 
structure  must  terminate  with  ENDIF. 

IMPORT  FROM  <  filename  >  [TYPE] 
PFS/DBASEII/FW2/RPD/WK1  '  'f'' 

Creates  dBASE  IV  files  from  PFS:FILE$  forms,  dBASE  II 
database  files,  Framework  II  database  and  spreadsheet 
frames,  and  from  RapidFile  data  files. 

INDEX  ON  <  key  expression  >  TO  <  .ndx  filename  >|/ 

TAG  <  tag  name  >  [OF  <  .mdx  filenai  ne  >  ]  [UNIQUE] 
[DESCENDING] 

Creates  an  index  in  which  records  from  a  database  file  are 
ordered  alphabetically,  chronologically,  or  numerically. 

INPUT  [<  prompt  >  ]  TO  <  memvar> 

Used  in  dBASE  programs  to  prompt  a  user  to  enter  an 
expression  from  the  keyboard.  Data  entry  is  terminated  by 


a 


INSERT  [BEFORE]  [BLANK] 

Adds  a  single  new  record  to  the  database  file  at  the  current 
record  location. 

JOIN  WITH  <  alias  >  TO  <  filename  > 

[FIELDS  <  field  list >  ]  FOR  <  condition  > 

Creates  a  new  database  file  by  merging  specified  records 
and  fields  from  two  open  database  files. 
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LABEL  FORM  <  label  filename  >  /?  [SAMPLE] 

[<  scope  >  ]  [FOR  <  condition  >  ] 

[WHILE  <  condition  >  ] 

[TO  PRINTER/TO  FILE  <  filename  >  ] 

Uses  a  specified  label  format  file  designed  with  MODIFY 
LABEL  to  print,  display,  or  write  labels  to  a  file  on  disk. 

LIST/DISPLAY  [[FIELDS]  <  expression  list>  ]  [OFF] 

[<  scope  >  ]  [FOR  <  condition  >  ] 

[WHILE  <  condition  >  ] 

[TO  PRINTER/TO  FILE  <  filename  >  ] 

Used  to  view  the  contents  of  a  database  file  in  an  unformat¬ 
ted  columnar  list. 

LIST/DISPLAY  FILES  [LIKE  <  skeleton  >  ] 

[TO  PRINTER/TO  FILE  <  filename  >  ] 

Displays  directory  information  similar  to  that  displayed  by 
the  DOS  DIR  command. 

LIST/DISPLAY  HISTORY  [LAST  <  expN>  ] 

[TO  PRINTER/TO  FILE  <  filename  >  ] 

Outputs  a  list  of  commands  that  have  been  executed  and 
are  stored  in  the  history  buffer. 

LIST/DISPLAY  MEMORY  [TO  PRINTER/TO  FILE 
<  filename  >  ] 

Provides  information  on  how  dBASE  IV  is  using  your)com- 
puter’s  m  emory. 

LIST/DISPLAY  STATUS  [TO  PRINTER/TO  FILE  <  filename  >  ] 

Provides  information  about  the  current  dBASE  IV  session. 

LIST/DISPLAY  STRUCTURE  [IN  <  alias  name>  ] 
Trq)gRINTER/TO  FILE  <  filename  >  1  _ 

r* /Displays  The  field  detinitlgng~bf  the  active  database  filtT) 

LIST/DISPLAY  USERS 

Identifies  the  workstations  currently  logged  in  to  dBASE  IV 
in  a  networking  environment. 

LOAD  <  binary  filename  > 

Loads  binary  program  files  in  memory. 

LOCATE  FOR  <  condition  >  [<  scope  >  ] 

[WHILE  <  condition  >  ] 

Searches  the  active  database  file  for  a  record  that  matches  a 
specified  condition. 

LOGOUT 

Logs  out  the  current  user  and  sets  up  a  new  log-in  screen. 


~L 
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MODIFY  COMMAND/FILE  <  filename  > 

[WINDOW  <  window  name  >  ] 

GiveSaccess  to  the  full-screen  program  editor.  The  editor 
creates  and  edits  dBASE  program,  format  files,  and  memo 
fields. 

MOVE  WINDOW  <  window  name  >~[TO  <  row  > 

<  column  >1/  BY  <  delta  row  >  ,<  delta  column  > 

Moves  a  window  to  a  new  location  on  the  screen. 

NOTE/*  <  text> 

f  [  <  command  >  ]  &&  <  text  > 

Iruiicates  comment  lines  in  a  program  (.prg)  file. 

ON  ERROF^ESCAPE?[g  command  ?  ]  ^ 

OffKEY  [<  key  (aBel  name  >  ]  [<  command  >  ] 

Branches  the  execution  of  a  program  if  an  error  occurs,  the 
Esc  key  is  pressed,  or  the  <  key  label  name>  key  is 
pressed. 

ON  PAD  <  pad  name>  OF  <  menu  name  > 

[ACTIVATE  POPUP  <  popup  name>  ] 

Associates  a  pop-up  menu  with  a  pad  of  a  given  bar  menu. 

ON  PAGE  [AT  LINE  <  expN>  <  command  >  ] 

Handles  page  breaks  with  footers  and  headers  while  print¬ 
ing  a  report. 

ON  READERROR  [<  command  >  ] 

Traps  errors  and  allows  for  error  recovery  during 
full-screen  operations. 

ON  SELECTION  PAD  <  pad  name  >  OF  <  menu  name  > 

[<  command  >  ] 

Associates  an  action  with  a  bar  menu  pad  so  that  selecting 
that  bar  menu  pad  executes  the  specified  comm ancQproce- 
dure,  or  program.  L - 

ON  SELECTION  POPUP  <  popup  name  >  /ALL 
[<  command  >  ] 

Specifies  the  command  or  procedure  that  executes  when  a 
pop-up  menu  selection  is  made. 

PACK 

Removes  records  that  are  marked  for  deletion  from  the 
active  database  file. 

PARAMETERS  <  parameter  list  > 

Assigns  local  variable  names  to  data  items  passed  from  a 
calling  program. 
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PLAY  MACRO  <  macro  name  > 

Executes  macros  created  from  the  Control  Center. 

PRINTJOB 


Immands  > 

(stem  variables  > 


(PRINT  JOB 


Itftictured  programming  commands  that  control  a  printjob. 


PRIVATE  ALL  [LIKE/EXCEPT  <  skeleton  >  ] 


<£> 


1 - PRIVATE  <  memvar  list>[/ARRAY 

<  array  definition  list >" 

Allows  you  to  create  local  memory  variables  and  array  ele¬ 
ments  in  a  lower-level  program  with  the  same  names  as 
memory  variables  and  array  elements  that  were  created  in  a 
calling  program  or  were  previously  declared  as  PUBLIC. 

PROCEDURE  <  procedure  name>^ 

Identifies  the  beginning  of  a  subroutine. 

PROTECT 

A  menu-driven  command  issued  inside  dBASE  IV  to  create 
and  maintain  security  on  a  dBASE  IV  system. 

PUBLIC  <  memory  variable  list  >[£ 

[ARRAY  <  array  definition  lisF>  ] 

Designates  memory  variables  that  you  can  use  in  any 
dBASE  program  or  subprogram.  Unlike  private  memory 
variables  and  array  elements,  public  variables  are  not 
released  when  the  program  ends. 

QUIT 

Closes  all  open  files,  terminates  the  dBASE  IV  session,  and 
returns  control  to  the  operating  system. 

READ  [SAVE] 

Activates  all  @...GETs  issued  since  the  last  CLEAR,  CLEAR 
ALL,  CLEAR  GETS,  or  READ  command.  It  is  most 
commonly  used  in  dBASE  program  files  for  full-screen 
entry  or  editing  of  data. 

RECALL  [<  scope  >  ]  [FOR  <  condition  >  ] 

[WHILE  <  condition  >  ] 

Reinstates  records  that  are  marked  for  deletion  in  the  active 
database  file. 

REINDEX 

Rebuilds  all  active  index  (.ndx)  and  multiple  index 
(.mdx)  files  in  the  current  work  area. 
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rREL 

DeT 


RELEASE  <  memvar  list  >  /[ALL 
[LIKE/EXCEPT  <  skeleton  >  ] 

•eletes  memory  variables  trom  K< 


S€j £  ZxPvA  C  r  (S)_ 

rsidv  r  PAA  c 


thereby  opening 
memory  space  for  other  use.  RELEASE  is  also  used  with  the 
appropriate  keyword  to  remove  LOADed  assembly  language 
programs,  menus,  popups,  and  windows  from  memory. 


RENAME  <  old  filename  >  TO  <  new  filename  > 

Changes  the  name  of  a  file. 


REPLACE  <  field  namel  >  WITH  <  expl  > 

[,<  field  name2>  >  WITH  <  exp2>  ...] 

[<  scope  >  ]  [FOR  <  condition  >  fftWHILE 

<  condition  >  ]  [ADDITIVE] 

Changes  the  contents  of  specified  fields  in  the  active7data- 
base  file.  1 — 

REPORT  FORM  <  report  form  filename  >  /? 

[PLAIN]  [HEADING  <  expC>  ]  [NOEJECT]  [SUMMARY] 
[<  scope  >  ]  [FOR  <  condition  >  ]7[WHILE 

<  condition  >  ] 

[TO  PRINTER/TO  FILE  <  filename  >  ] 

Prints  information  from  the  active  database  using  a  report 
form  file  created  by  CREATE/MODIFY  REPORT.  You  may 
direct  a  report  to  the  screen,  the  printer,  or  to  an  ASCII 
text  file. 


RESET  [IN  <  alias  name>  ] 

Removes  the  integrity  tag  from  a  file. 

RESTORE  FROM  <  filename  >  [ADDITIVE] 

Retrieves  and  activates  memory  variables  and  arrays  from  a 
memory  file. 

RESTORE  MACROS  FROM  <  macro  f ile  > 

Restores  macros  that  were  saved  to  a  file. 


RESTORE  WINDOW  <  window  name  list>  /ALL  FROM 
<  filename  > 

Restores  window  definitions  from  a  disk  file  to  memory. 


RESUME 

Causes  a  SUSPENDed  program  to  continue  execution. 


RETRY 

Re-executes  a  command  sequence  that  caused  an  error. 


RETURN  [TO  MASTER]  [<  exp>  ] 

Restores  control  to  calling  programs,  or  to  the  dot  prompt. 
When  control  is  restored,  the  command  following  the  call¬ 
ing  command  is  executed. 
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UPDATE  ON  <  key  field  >  FROM  <  alias  name> 

REPLACE  <  field  name  1  >  WITH  <  expression  1  > 

[,<  field  name  2>  WITH  <  expression  2>  ...] 
[RANDOM] 

Uses  data  from  another  database  file  to  replace  fields  in  the 
current  database  file.  It  makes  the  changes  by  matching 
records  in  the  two  database  files  based  on  a  single  key  field. 

USE  [<  database  filename  >  /?] 

IN  <  work  area  number  >  ] 

[INDEX  <  ndx  or  .mdx  file  list>  ] 

ORDER  <  .ndx  filename  >  /<  .mdx  tag  > 

'  OFl<  .mdx  filename  >  ]] 

WAS  <  alias  name>  ]  [EXCLUSIVE]] 

Opens  an  existing  database  file  and  may  open  .mdx  and 
.ndx  index  files.  If  the  database  contains  memo  fields,  the 
associated  .dbt  file  is  opened  automatically. 

WAIT  [<  prompt  >  ]  [TO  <  memvar>  ] 

Causes  all  dBASE  IV  processing  to  pause  until  any  key  is 
pressed. 

ZAP 

Removes  all  records  from  the  active  database  file. 
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SET  Commands 


This  section  lists  the  SET  commands  of  dBASE  IV.  Default 
settings  are  shown  in  upper  case. 

Commmands  identified  with  an  *  may  be  changed  through 
the  Config.db  file.  See  Chapter  6,  “Customizing  dBASE  IV.’ 


SET 

Displays  the  menu  for  setting  most  parameters  of 
dBASE  IV. 

*SET  ALTERNATE  on/OFF 

Sends/does  not  send  screen  output  to  a  text  file. 

SET  ALTERNATE  TO  [<  filename  >  ]  [ADDITIVE] 

Sends  screen  output  to  a  file;  erases  existing  file  or  adds  to 
the  end  with  ADDITIVE. 


*SET  AUTOSAVE  on/OFF 

Saves  each  record  to  the  disk  after  a  single  I/O  operation. 
The  default  is  OFF  to  allow  you  to  abandon  edits  or  changes 
you  are  not  sure  of. 


*SET  BELL  ON/off 

Sets  the  audio  alarm  on  or  off. 


*SET  BELL  TO  [<  frequency  >  .<  duration >  ] 

Sets  the  tone  and  duration  of  the  audio  alarm.  Default  is 
512  hertz,  2  ticks. 

*SET  BLOCKSIZE  TO  <  expN> 

Sets  memo  fields  and  .mdx  file  blocks  to  multiples  of  512 
bytes.  Default  is  1. 

*SET  BORDER  TO  [SINGLE/DOUBLE/PANEL/NONE/ 

<  border  definition  string  >  ] 

Sets  menu,  window,  and  popiup  borders. 

*SET  CARRY  on/OFF 

Carries  forward  changes  made  in  the  contents  of  the  last 
record  in  APPEND,  BROWSE,  EDIT,  INSERT  or  CHANGE. 
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SET  CARRY  TO  [<  field  name  list>  J  [ADDITIVE] 

Determines  which  fields  are  carried  forward.  Updates  only 
specified  fields.  If  ADDITIVE  is  used,  the  field  list  is  added 
to  previous  fields  specified  with  SET  CARRY. 

*SET  CATALOG  on/OFF 

Adds/does  not  add  files  opened  with  the  SET  VIEW  com¬ 
mand  to  the  current  catalog. 

SET  CATALOG  TO  [<  filename  >  /?] 

Opens  or  names  the  catalog  file. 

*SET  CENTURY  on/OFF 

Displays/does  not  display  the  century  in  a  date  field. 

*SET  CLOCK  on/OFF 

Displays/  does  not  display  the  system  clock  at  the  upper 
right  corner  of  the  screen. 

*SET  CLOCK  TO  [<  row>  ,<  column >  ] 

Changes  the  position  of  the  clock  display.  Default  is  0,68. 

*SET  COLOR  on/OFF 

Toggles  between  monochrome  and  color  monitors. 

*SET  COLOR  TO  [[<  standard  >  ]  [.<  enhanced  >  ] 
[,<lborder>  ]  [^ackground/j] 

Sels  overall  color  parameters  of  screen  areas. 

*SET  COLOR  OF  NORMAL/MESSAGES/TITLES/ 

HIGHLIGHT/BOXES/ALERT  /FIELDS  TO  [<  attribute  >  ] 

Lets  you  set  the  color  attributes  of  screen  area  groupings^ 
Please  see  the  description  of  this  command  in  Languag e^-^ 
Reference  for  the  screen  area  in  each  group,  and  for  color 
attribute  names. 

_*SET  CONFJRM  on/OFF  - 

■nopskinZskip/'to  the  next  field  in  the  full  screen 
'  mode*  '---•***  * 

*SET  CONSOLE  ON/off 

Displays/does  not  display  output  on  the  screen. 

*SET  CURRENCY  LEFT/right 

Displays  the  currency  symbol  on  the  left  or  the  right  of  the 
numeric  value. 

*SET  CURRENCY  TO  [<  expC>  ] 

Changes  the  currency  symbol  displayed.  Default  is  $. 
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*SET  DATE 


Italian  /iapan/usa/mdY/dmy/ymd  -  — i _ j 

Sets  the  date  format  lor  diiierent  countries. 

*SET  DEBUG  on/OFF 

Sends/does  not  send  the  output  of  SET  ECHO  ON  to  the 
printer. 

*SET  DECIMALS  TO  <  expN> 

Sets  the  number  of  decimals  displayed.  Maximum  is 
{{was  15,  went  up  to  18?}}.  Default  is  2. 

*SET  DEFAULT  TO  <  drive  >  [:] 

Specifies  the  default  drive. 

*SET  DELETED  on/OFF 

Uses/does  not  use  records  marked  for  deletion. 

*SET  DELIMITERS  ON/off 

Uses/does  not  use  specified  entry  delimiters. 

SET  DELIMITERS  TO  <  expC>  /DEFAULT 

Specifies  delimiters  for  full-screen  field  and  variable/dis¬ 
plays.  * — 

*SET  DESIGN  ON/off 

Prevents  transfers  to  design  mode  from  the  dot  prompt  or 
from  the  Control  Center. 

SET  DEVELOPMENT  on/OFF 

Compares  the  dates  of  program  source  files  to  object  files 
created  with  an  external  editor.  If  the  source  file  is  newer, 
dBASE  IV  recompiles  the  source  file  to  create  a  matching 
object  file. 

*SET  DEVICE  TO  SCREEN/printer/file  <  filename  > 

Sends  output  of  the  @...SAY  command  to  the  screen,  to  a 
printer,  or  to  a  file. 


— (EGA43/MONQ43/VGA25 

Sets  display  mode  to  monochrome,  color,  25-line  or  43-line 
EGA,  or  43-line  monochrome  for  systems  equipped  with 
graphics  cards  that  support  these  modes.  It  also  supports 
the  VGA  graphics  card. 

*SET  ECHO  on/OFF 

Sends/does  not  send  the  commands  as  they  are  executed  to 
the  screen  or  printer. 
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*SET  ENCRYPTION  ON/off 

Encrypts/does  not  encrypt  files  that  were  originally 
encrypted  by  using  PROTECT,  when  these  files  are  later 
copied.  Cannot  encrypt  files  by  itself  without  PROTECT. 

*SET  ESCAPE  ON/off 

Interrupts/does  not  interrupt  program  execution  when  the 
Esc  key  is  pressed. 

*SET  EXACT  on/OFF 

Requires/does  not  require  absolute  matches  in  character 
com  parison. 

*SET  EXCLUSIVE  ON/off 

Sets  exclusive/non-exclusive  access  to  files  on  multi-user 
system,.  *\ 

*SET  FIELDS  on/OFF 

Respects/ ignores  the  field  list. 

SET  FIELDS  TO  [<  field  >  [/R]/<  calculated  field  id>  ...] 

[,  <  field  >  [/R]/  <  calculated  field  id  >  ...] 

Defines  a  list  of  fields  that  may  be  accessed  in  one  or  more 
files. 

SET  FIELDS  TO  ALL  [LIKE/EXCEPT  <  skeleton  >  ] 
[ADDITIVE] 

Sets  a  field  list  using  wildcard  characters. 

SET  FILTER  TO  [FILE  <  filename  >  /?]  [<  condition  >  ] 

Displays  only  the  records  that  meet  the  specified  condition. 

*SET  FIXED  on/OFF 

This  command  is  maintained  for  dBASE  III  PLUS  compati¬ 
bility.  It  has  no  effect  in  dBASE  IV. 

SET  FORMAT  TO  <  format  filename  >  /? 

Uses  the  specified  format  file  for  data  entry. 

*SET  FUNCTION  <  expN>  TO  <  expC> 

Programs  function  keys. 

*SET  HEADING  ON/off 

Displays/does  not  display  field  names  above  the  fields  in 
LIST,  DISPLAY,  SUM,  or  AVERAGE. 

*SET  HELP  ON/off 

Prompts/does  not  prompt  for  help  when  an  error  occurs. 

*SET  HISTORY  ON/off 

Saves/does  not  save  command  execution  in  a  history  buffer. 
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•SET  HISTORY  TO  <  expN> 

Specifies  the  number  of  commands  to  save  in  the  history 
buffer.  Default  is  20. 

•SET  HOURS  TO  [12/24] 

Displays  a  12-hour  clock/24-hour  clock.  Default  is  12-hour. 

SET  INDEX  TO  <  list  of  .ndx  or  .mdx  filenames  >  /? 

[ORDER  <  .ndx  f ilename/TAG  >  <  .mdx  tag  name> 

[OF  <  .mdx  filename  >  ]] 

Opens  .ndx  and  .mdx  files,  and  specifies  the  master  index 
for  a  database  file. 

•SET  INSTRUCT  ON/off 

T\irns  on/off  the  instruction  boxes  in  the  dBASE  IV  menu 
interface. 

•SET  INTENSITY  ON/off 

Uses/does  not  use  the  enhanced  display. 

•SET  LOCK  ON/off 

Uses/does  not  use  all  features  of  automatic  record  locking.^ 
See  the  SET  LOCK  command  in  Language  Reference  for  the 
effect  of  this  command  on  automatic  locking. 

•SET  MARGIN  TO  <  expN> 

Controls  the  printer  left  margin  setting.  Default  is  0. 

•SET  MARK  TO  [<  expC>  ] 

Changes  the  date  separator  character.  Default  is  a  slash  (/). 

•SET  MEMOWIDTH  TO  <  expN> 

Sets  width  of  memo  fields  in  columns.  Default  is  50  charac¬ 
ters,  minimum  is  5,  and  maximum  is  250. 

•SET  MENU  ON/off 

This  command  is  not  functional  in  dBASE  IV,  only  in 
dBASE  III  PLUS.  Use  SET  INSTRUCT  with  dBASE  IV  to 
control  display  of  instruction  boxes. 

SET  MESSAGE  TO  [<  expC>  ] 

Displays  a  user-defined  message  at  the  bottom  of  the  screen, 
if  SET  STATUS  is  ON. 

•SET  NEAR  on/OFF 

If  ON,  displays  the  next  closest  value  in  a  sort  when  the 
sought  value  is  not  found.  If  OFF,  displays  EOF  when  the 
value  is  not  found. 

•SET  ODOMETER  TO  [<  expN>  ] 

Defines  the  update  interval  of  the  record  counter  for  com¬ 
mands  that  display  a  record  count.  Default  is  1. 
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SET  ORDER  TO  [<  expN>  ]/[TAG  <  .mdx  tag>  / 

[OF  <  .mdx  filename  >  ]] 

Sets  up  a  master  index.  Specifies  order  by  the  index  tag  or 
filename. 

*SET  PATH  TO  [<  path  list>  ] 

Sets  the  directory  path  to  be  searched  for  executable  files. 

*SET  POINT  TO  [<  expC>  ] 

Sets  the  character  used  for  the  decimal  point.  Default  is  the 
period. 

*SET  PRECISION  TO  <  expN> 

Sets  precision  to  be  used  in  fixed  point  arithmetic.  Range  is 
10  to  20,  default  is  16. 

*SET  PRINTER  on/OFF 

Sends/does  not  send  all  output  to  a  printer. 

*SET  PRINTER  TO  <  DOS  device  > 

Sends  printer  output  to  a  local  printer.  Default  is  LPT1. 

SET  PRINTER  TO  \\<  computer  name>  \<  printer  name> 
=  destination/\\SPOOLER/\$&PTURE 

Redirects  printer  output  to  the  specified  device;  supports 
network  printing. 

SET  PRINTER  TO  FILE  <  filename  > 

Redirects  printer  output  to  a  disk  file,  which  can  be  format¬ 
ted  for  a  specific  printer. 

*SET  PROCEDURE  TO  [<  procedure  filename  >  ] 

Opens  a  procedure  file. 

SET  REFRESH  TO  <  expN> 

Determines  the  interval  for  checking  to  see  if  a  record  in  a 
multi-user  file  has  changed  during  BROWSE  and  EDIT  only. 
Default  is  0,  and  the  range  is  from  1  to  3600  seconds. 

SET  RELATION  TO  <  expNI  >  INTO  <  alias  1  > 

[<  expN2>  INTO  <  alias  2>  ...] 

Links  specified  database  files  according  to  an  index  key  or  a 
record  number. 

*SET  REPROCESS  TO  <  expN> 

Sets  the  number  of  retries  before  dBASE  IV  stops  trying  to 
execute  a  command. 

*SET  SAFETY  ON/off 

Asks/does  not  ask  before  overwriting  an  existing  file. 
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*SET  SCOREBOARD  ON/off 

Displays/does  not  display  dBASE  IV  messages  on  line  1,  if 
SET  STATUS  is  OFF. 

SET  SEPARATOR  TO  [<  expC>  ] 

Sets  the  character  used  as  the  numeric  separator.  Default  is 

fU  a  /«  /\  •««  «vk  n 


priorities  when  updating  records. 

SET  SPACE  ON/off 

Lets  the  ?  and  ??  commands  print  a  space  between  the 
printed  expressions. 

*SET  SQL  on/OFF 

Activates/deactivates  the  SQL  mode. 

*SET  STATUS  ON/off 

Displays/does  not  display  the  status  bar. 

*SET  STEP  on/OFF 

Stops/does  not  stop  program  execution  after  each 
command. 

*SET  TALK  ON/off 

Displays/does  not  display  command  execution  to  the 
screen. 

*SET  TITLE  ON/off 

TUrns  the  catalog  file  title  prompt  on  and  off. 

*SET  TRAP  on/OFF 

Calls/does  not  call  the  debugger  when  an  error  occurs  dur¬ 
ing  program  execution. 

*SET  TYPEAHEAD  TO  <  exgN> 

Specifies  the  size  of  the  typeahead  buffer.  Default  is  20. 

*SET  UNIQUE  on/OFF 

Displays  the  first  record/all  records  with  identical  keys  in 
an  index  file. 

SET  VIEW  TO  <  query  filename  >  /<  view  filename  >  /? 

Opens  one  or  more  files;  adds  filenames  to  any  active 
catalog  file. 

SET  WINDOW  OF  MEMO  TO  <  window  name> 

Uses  the  named  window  for  editing  a  memo  field  while  in 


BROWSE  or  EDIT. 
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Functions 


These  are  covered  in  detail  in  Chapter  4  of  Language 
Reference. 

&  <  character  variable >  [.]  [<  cstring>  ] 

Macro  substitution. 

ABS(<  expN>  ) 

Absolute  value. 


ACCESSO 

Access  level  of  the  current  user  as  defined  with  PROTECT. 


ACOS(<  expN>  ) 

Angle  size  in  radians  from  the  cosine. 

ALIAS([<  expN>  ]) 

Alias  name  of  a  work  area. 

ASC  (<  expC>  ) 

Character  to  ASCII  decimal  conversion. 


ASIN(<  expN>  ) 

Angle  size  in  radians  from  the  sine. 

AT(<  expC>  ,<  expC >  /memvar) 

Substring  search  in  a  character  or  memo  expression. 

ATAN(<  expN>  ) 

Angle  size  in  radians  from  the  tangent. 

ATN2(<  expNI  >  ,<  expN2>  ) 

Angle  size  in  radians  from  the  sine  <  expNI  >  and  cosine 
<  expN2  >  . 

BAR() 

Number  of  last  selected  prompt  bar  from  the  active  pop-up 
menu. 

BOF([<  alias  >  ]) 

Beginning  of  file. 
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CALL(<  filename>  ,<  expC>  /<  memvar >  ) 

Executes  a  LOADed  binary  program  module. 

CDOW(<  expD>  ) 

Name  of  the  day  of  the  week. 

CEILING(<  expN>  ) 

Smallest  integer  greater  than  or  equal  to  the  specified 
value. 

CHANGE() 

Determines  if  a  record  has  been  changed  by  a  user  on  a 
network. 

CHR(<  expN  >  ) 

ASCII  decimal  to  character  conversion. 

CMONTH(<  expD>  ) 

Name  of  the  month  from  a  date. 

COL() 

Cursor  column  position  on  screen. 

COMPLETED() 

Transaction  completed  or  not. 

COS(<  expN>  ) 

Cosine  value  from  angle  in  radians. 

CTOD(<  expC>  ) 

Character  to  date  conversion. 

DATE() 

System  date.  Default  is  mm/dd/yy. 

DAY(<  expD>  ) 

Number  of  the  day  of  the  month  from  a  date. 

DBF([<  alias  >  ]) 

Name  of  the  database  file  in  USE. 

DELETED([<  alias  >  ]) 

Is  record  marked  for  deletion  or  not/" 

✓v 

DIFFERENCE(<  expC>  ,<  expC>  ) 

Difference  between  two  SOUNDEXQ  codes. 

DISKSPACEO 

Number  of  free  bytes  on  the  disk  default  drive. 

DMY(<  expD>  ) 

Date  format  conversion  to  DD  Month  YY. 
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DOW(<  expD>  ) 

Number  of  the  day  of  the  week  from  a  date. 

DTOC(<  expD>  ) 

Date  to  character  conversion. 

DTOR(<  expN>  ) 

Degrees  to  radians  conversion. 

DTOS(<  expD>  ) 

Date  to  character  date  conversion,  for  indexing. 

EOF([<  alias  >  ]) 

End  of  file. 

ERROR() 

Error  number  of  last  error  condition. 


EXP(<  expN>  ) 

Number  from  its  natural  log. 

FIELD([a!ias  name]) 

Names  of  fields  from  their  numbers. 


FILE(<  expC>  ) 

Verifies  the  existence  of  a  file. 

FIXED(<  expN>  ) 

Converts  long,  real  floating  point  numbers  to  binary  coded 
decimal. 

FKLABEL(<  expN>  ) 

Name  of  function  key  from  its  number. 

FKMAX() 

Maximum  number  of  programmable  function  keys. 

FLOAT (<  expN>  ) 

Converts  binary  coded  decimal  numbers  to  long,  real  float¬ 
ing  point. 


FLOCK([alias]) 

Locks  a  database  file. 


FLOOR  (<  expN>  ) 

Largest  integerless  than  or  equal  to  the  specified  value. 

A 

FOUND([<  alias  >  ]) 

Logical  result  of  a  database  search. 

FV(<  payment  >  .  <  rate>  ,  <  periods  >  ) 

Future  value  of  investment  at  fixed  interest  for  a  given  time. 
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GETENV(<  expC>  ) 

Returns  DOS  set  environment  parameters. 

IIF(<  expL>  .<  expl  >  .<  exp2>  ) 

Immediate  IF. 

INKEY() 

Decimal  ASCII  value  of  the  last  key  pressed. 

INT(<  expN>  ) 

Conversion  to  integer  by  truncating  decimals. 

ISALPHA(<  expC>  ) 

First  character  a  letter  or  not. 

ISCOLOR() 

Checks  the  color  hardware  address  of  the  system  and 
returns  a  logical  true  (.T.)  or  false  (.F.). 

ISLCWER(<  expC>  )  _ 

First  character  is  lower  case  or  not. 

A 

ISMARKED([<  alias >  ]) 

Is  the  database  file  in  transition  or  notx^ 

A 

ISUPPER(<  expC>  )  - 

First  character  is  upper  case  or  not. 

KEY([<  .mdx  file >  ,]  <  expN >  [,<  alias  name>  ]) 

Key  expression  for  the  specified  index  file. 

LASTKEY() 

Decimal  ASCII  value  of  key  pressed  to  exit  full-screen 
command. 

LEFT(<  expC>  ,<  expN>  ) 

Specified  number  of  characters  counting  from  left  of  string. 

LEN(<  expC>  ) 

Number  or  characters  in  a  specified  string  or  a  memo  field. 

LIKE  (<  pattern  >  ,<  expC>  ) 

Compares  strings  using  wildcards. 

LINENO() 

Returns  line  number  to  be  executed  next  in  the  current 
program. 
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LKSYS(n) 

Returns  the  time,  date,  and  log-in  name  for  a  file  locked  on 
a  network: 

n  =  0,  time  when  the  lock  was  placed; 
n  =  1,  date  when  the  lock  was  placed; 
n  =  2,  log-in  name  of  the  user  who  locked  the  record. 

LOCK([<  expC  list  >  ]  [.<  alias  name  >  ]) 

Locks  one  or  more  database  records  in  networking;  same  as 
RLOCK(). 

LOG(<  expN>  ) 

Natural  logarithm  to  base  e. 

LOG10(<  expN>  ) 

Logarithm  to  base  10. 

LOOKUP  (<  return  exp>  ,  <  look-for  exp>  , 

<  look-in  field  >  ) 

Looks  up  record  from  another  database  file. 

LOWER (<  expC>  )  _ 

Converts  uppercase  letters  to  lower-case. 

LTRIM(<  expC>  ) 

Removes  leading  blanks  from  a  character  string. 

LUPDATE([<  alias  >  ]) 

Last  date  of  file  UDdate. 


MDX(<  expN>  [,<  alias  name>  ]) 

Returns  name  of  an  open  .mdx  file. 

MDY(<  expD>  ) 

Converts  the  date  format  to  Month  DD,  YY. 

MEMLINES(<  memo  field  name>  ) 

Number  of  word-wrapped  lines  in  memo  field  at  current 
width. 

MEMORY([0]) 

Amount  of  RAM  in  kilobytes  (1,024-byte  units).  Optional 
zero  does  not  affect  result. 

MENU() 

Name  of  the  active  menu. 

MESSAGE() 

Error  message  string  of  the  last  error. 
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MIN(<  expl  >  ,<  exp2>  ) 

Lesser  of  two  values. 

MLINE(<  memo  field  name >  ,<  expN>  ) 

Specifies  a  line  of  a  memo  field. 

MOD(<  expNI  >  ,<  expN2>  ) 

Modulus  (remainder  from  the  division  of  numeric  expres¬ 
sion  1  by  numeric  expression  2). 

MONTH(<  expD>  ) 

Number  of  month  from  a  date. 

NDX(<  expN>  [,<  alias  name>  ]) 

Returns  name  of  an  open  .ndx  file. 

NETWORK()  - 

Is  dBASE  IV  installed  and  running  on  a  network  or  not/ 

A 

ORDER([<  alias  name>  ]) 

Name  of  primary  order  index  file  or  .mdx  tag. 

OS() 

Operating  system  in  use. 

PAD() 

Selected  prompt  pad  name  of  the  active  menu. 

PAYMENT(<  principal  >  ,<  rate>  ,<  periods  >  ) 

Periodic  payment  on  a  loan  with  fixed  interest. 

PCOL() 

Printer  column  position. 

p,() 

Mathematical  constant  for  the  ratio  of  circumference  to 
diameter. 

popupo 

Name  of  the  active  pop-up  menu. 

PRINTSTATUS() 

Returns  printer  status. 

PROGRAM() 

Returns  name  of  program  being  executed  when  an  error 
occurred.  ^ 

PROMPT() 

Prompt  of  the  last  selected  popup  or  menu  option. 


t),- 
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PROW() 

Printer  row  position. 

PV(<  payment >  ,<  rate >  ,<  periods  >  ) 

Present  value  of  equal  payments  invested  at  fixed  interest 
for  a  given  tim  e. 

RAND([<  expN>  ]) 

Random  number  generator.  Seed  number  is  optional. 

READKEY() 

Value  of  key  pressed  to  exit  full-screen  menu. 

READVARQ 

Name  of  field  or  memory  variable  being  edited. 

RECCOUNT([<  alias  name>  ]) 

Number  of  records  in  the  current  database  file. 

RECNO([<  alias  name>  ]) 

Current  record  number  of  selected  database  file. 


RECSIZE([<  alias  name>  ]) 

Size  of  a  record  in  selected  database  file. 


REPLICATE(<  expC>  ,<  expN>  ) 

Repeats  a  character  expression  a  specified  number  of  times. 

RIGHT(<  expC>  ,<  expN>  ) 

Specified  number  of  characters  counting  from  right  of 
string. 

RLOCK([<  expC  list  >  ]  [,<  alias  name>  ]) 

Locks  one  or  more  database  records  in  networking;  same  as 
LOCK(). 


ROLLBACK() 

Was  the  most  recent  rollback  successful  or  not./*" 
ROUND(<  expNI  >  ,<  expN2>  ) 

Rounds  the  number  in  <  expNI  >  to  the  number  ofroeci- 
mals  specified  in  <  expN2  >  . 

RCW() 

Row  number  of  the  current  cursor  position. 

RTOD(<  expN>  ) 

Converts  radians  to  degrees. 


7> 


Z 


RTRIM(<  expC>  ) 

Removes  trailing  blanks;  same  as  TRIM(). 
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SEEK(<  expC>  [,<  alias  name>  ]) 

Is  the  index  key  found  or  not—*" 

*  ^ 

SELECTO 

Returns  the  number  of  the  highest  unused  work  area. 

SET(<  expC>  ) 

Returns  parameters  of  SET  ON/OFF  commands. 

SIGN(<  expN>  ) 

Mathematical  sign  of  a  number  or  expression. 

SIN(<  expN>  ) 

Sine  from  an  angle  in  radians. 

SOUNDEX(<  expC>  ) 

Returns  the  four-character  code  used  as  an  index  to  find 
possible  matches  in  sound-alike  searches. 

SPACE (<  expN>  ) 

Specifies  a  string  made  of  blank  spaces;  maximum  is  254. 

SQRT(<  expN>  ) 

Square  root  of  the  specified  number. 

STR(<  expN>  [,<  length  >  ]  [,<  decimal  >  1) 

Number  to  character  string  conversion. 

STUFF(<  expl  >  ,<  expNI  >  ,<  expN2>  ,<  exp2>  ) 

Replaces  part  of  a  character  string  or  memo  field  with 
another  specified  character  string. 

SUBSTR(<  expC>  ,<  starting  position > 

[,<  number  of  characters  >  ]) 

Extracts  a  specified  number  of  characters  from  a  string  or 
memo  field,  counting  from  the  right. 

TAG([<  .mdx  file  >  ,]  <  expN>  [,<  alias  name>  ]) 

Returns  the  tag  name  in  a  specified  .mdx  file. 

TAN(<  expN>  ) 

Tangent  from  an  angle  in  radians. 

TIME() 

System  clock.  Format  is  hh:mm:ss. 

TRANSFORMS  exp>  ,<  expC>  ) 

Picture  formatting  of  character,  logical,  date,  and  numeric 

data  without  using  ffr;  <5^ 
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TYPE(<  expC>  )  _ 

Returns  a  single  uppercase  letter  C,  N,  L,  M,  D,  or  U  repre¬ 
senting  the  data  type  of  the  evaluated  expression. 

TRIM() 

Removes  trailing  blanks;  same  as  RTRIM(). 

UPPER(<  expC>  ) 

Converts  lowercase  letters  to  upper  case. 

A  A 

USER() 

Returns  the  log-in  name  of  an  operator  currently  logged  in 
to  a  system  that  uses  PROTECT  to  encrypt  files. 

VAL(<  expC>  ) 

Character  to  number  conversion. 

VERSION() 

Returns  the  dBASE  IV  version  number  in  use. 

YEAR(<  expD>  ) 

Year  from  a  date  expression. 
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System  Memory  Variables 


dBASE  IV  uses  a  group  of  predefined  system  memory  vari¬ 
ables  to  control  printer  parameters  and  the  appearance  of 
text  on  the  printed  page.  System  variable  names  all  start 

with  an  underline  character. 

* 

dBASE  IV  assigns  defaults  to  the  system  memory  variables 
upon  start-up.  You  can  change  these  defaults  any  time  from 
the  report  generator, (6^  from  the  dot  prompt,  or  from 
within  programs.  ve_ 


C-) 


In  the^following  syntax  descriptions,  defaults  are  shown  in 
uppercase  letters;  however,  system  memory  variables  are 
not  case  sensitive.  Some  system  memory  variables  require  a 
second  system  memory  variable  as  a  co-requisite  before 
they  take  effect.  When  this  is  shown  in  the  syntax,  set  the 
co-requisite  value  first. 


.alignment  =  '  LEFT*  /*  right"  /'  center" 

Aligns  text  on  the  page,  as  left  flush,  right  flush,  or 
centered. 

_  box  =  .T./.f. 

Prints  or  does  not  print  boxes  defined  with  the  DEFINE 
BOX  command. 


_  indent  =  O/any  integer  to  254 

Co-requisite:  .wrap  =  .T. 

Indents  paragraphs  by  the  specified  number  of  columns. 
The  maximum  indent  must  be  less  than  the  .rmargin  set¬ 
ting.  The  indent  value  starts  at  the  .Imargin  setting. 


.Imargin  =  O/any  integer  to  254 

Co-requisite:  .wrap  =  .T. 

Prints  text  with  the  specified  left  margin.  It  is  additive  to  the 
.poffset  value. 

.Imargin  must  be  less  than  the  right  margin  setting. 


Jllfj 
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_padvance  =  'FORMFEED* /'linefeeds* 

Uses  either  formfeeds  or  linefeeds  to  advance  the  paper  in 
the  printer. 

_  page  no  =  1/any  integer  to  32,767 

Starts  a  printjob  at  the  specified  page  number. 

_pbpage  =  1  /any  integer  to  32,767 

Begins  a  page  number  at  a  specific  page  of  a  document.  The 
beginning  page  number  can  be  less  than  or  equal  to  the 
_pepage  value. 


_  pcolno  =  O/any  integer  less  than  _  margin 

Moves  the  printhead  to  the  specified  column  number  on  the 
printed  page.  The  next  character  is  printed  at  that  column. 


_pcopies  =  1 /any  integer  to  32,767 

Specifies  the  number  of  copies  to  print. 

_pdriver  =  \DOS  pathAilename  of  the  printer  driver 

Assigns  different  printer  drivers.  If  no  printer  driver  is  in 
the  Config.db  file,  the  default  is  Generic.pr2;  otherwise,  the 
default  is  the  printer  driver  in  the  Config.db  file.  DOS  path 
is  required  only  when  the  printer  driver  is  not  in  the  cur¬ 
rent  directory. 


_  pecode  =  character  string  up  to  255 

Sends  escape  sequences  (control  codes)  to  the  printer  using 
delimiters  and  curly  braces.  To  send  an  Escape  character, 
use  either  "  {ESC}"  or  its  ASCII  value  "{27}"  followed  by  any 
letter  or  number.  To  send  an  Escape  A,  use  "{ESC}A",  or 
"{ESC}"  "{65}". 

To  send  the  curly  brace  character,  also  use  curly  braces 
"iO",  or  "{}}". 


List  of  Control  Character  Specifiers: 

"{0}"  through  "  {255}"  —  ASCII  values 

"{ESC}"  or  "{27}"  —  Escape  character 

"{BACKSPACE}"  or  "{8}"  —  Backspace  character 

"{BELL}"  or  "{7}"  —  Bell  or  audio  alarm  character 

"{TAB}"  or  "{9}"  —  Tab  character 

"{NULL}"  or  "{0}"  —  Null  character  or  ASCII  zero 

"{RETURN}"  or  "{13}"  —  Return  character 

"{DEL}"  or  "{127}"  —  Delete  character 

"{CTRL-A}"  through  "  {CTRL-Z}"  —  Control  and  letter 

combinations 


_peject  =  'BEFORE' /'after* /'both' /'none' 

Sends  a  formfeed  to  the  printer  before  starting  a  printjob. 
BEFORE  is  the  default  for  dBASE  III  PLUS  compatibility. 
If  this  is  not  a  consideration,  change  the  default. 
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pepage  =  1/any  integer  to  32,767 

Stops  a  printjob  when  the  specified  page  number  is  printed, 
even  when  there  are  more  pages  in  the  document  or  report. 

pform  =  "/print  form  filename 

Sends  a  null  string  to  the  printer  as  the  name  of  the  print 
form  file.  You  can  specify  any  form  filename  and  include  its 
DOS  file  path  if  it  is  not  in  the  current  directory.  _pform 
file  is  a  binary  file  that  contains  all  the  system  memory  vari¬ 
able  settings.  You  can  override  one  or  more  of  the  variables 
contained  in  a  form  file  from  the  dot  prompt  or  from  within 
programs.  The  last  assigned  memory  variable  setting  takes 
precedence. 

_plength  =  1/any  integer  to  32,767 

Specifies  the  page  length. 

_  plineno  =  O/any  integer  less  than  _  plength 

Moves  the  printhead  to  the  line  number  specified.  If  the 
line  number  is  greater  than  its  current  position,  the/fcrin- 
thead  advances  to  the  line  number  specified.  If  thenne 
number  is  less  than  its  current  position,  the  printhead 
advances  to  that  line  number  on  the  next  page. 

_  ploff set  =  O/any  integer  less  than  _  pwidth 

Sets  the  page  left  offset.  It  is  the  same  as  the  SET  MARGIN 
command.  It  controls  the  left  margin  for  the  printed  output 
without  affecting  the  left  margin  of  displayed  text. 


Z- 


_ppitch  =  'DEFAULT'/' pica*/*  elite' /'condensed' 

Controls  the  pitch  (size)  of  printed  output.  The  default  is  no 
pitch  control,  so  that  the  printer  hardware  default  setting  is 
used  until  you  enter  a  value  for  _ppitch. 

_pquality  =  .F./.t. 

Sets  the  printed  output  to  letter-quality  mode  for  all  print¬ 
ers  that  support  this  setting.  The  default  setting  is  false  (.F.), 
even  if  the  hardware  default  of  the  printer  is  set  to  letter 
quality.  To  synchronize  the  default  with  a  printer  in  letter- 
quality  mode,  set  _pquality  to  true  (.T.). 


_  pscode  =  starting  control  string 

Sends  a  control  sequence  to  the  printer  to  specify  typeface 
changes.  Used  to  turn  on  attributes  such  as  bolding,  under¬ 
lining,  or  italics  anywhere  in  a  document.  No  default.  Lim¬ 
ited  to  character  types  supported  by  the  printer  in  use. 

Use  _pecode  =  ending  control  string  to  terminate  the 
typeface  specified  with  _pscode. 


A 

A 
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_ps  pacing  =  1/2/3 

Controls  the  line  spacing  on  the  printed  page;  default  is  1 
for  single  spacing. 

_pwait  =  .F./.t. 

Supports  individual  sheet  printing  by  pausing  after  page 
breaks  and  displaying  a  prompt  to  let  you  insert  paper. 

_  rmargin  =  80/any  integer  between  1  and  255 

Co-requisite:  _wrap  =  .T. 

Sets  the  right  margin.  Default  is  80. 

_tabs  =  "/ascending  tab  position  integers  separated 
by  commas 

The  default  setting  is  a  null  string  when  dBASE  IV  uses  the 
DOS  default  of  a  tab  every  8  columns.  The  maximum  num¬ 
ber  of  tabs  is  30. 

^  wrap  =  .F./.t. 

Enables  word  wrap.  Must  be  set  to  true  (.T.)  for  th^_ align¬ 
ment,  _indent,  _lmargin,  and  _rmargin  memory  variables 
to  work. 
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SOL  Commands  and 

Functions 


These  are  covered  in  detail  in  Using  dB AS E IV SQL. 


SQL  Commands 


ALTER  TABLE  <  table  name  > 

ADD  (<  column  name>  <  data  typo  ) 

[,<  column  name  >  <  data  type  > 

Add^new  columns  to  an  existing  table. 

CLOSE  <  cursor  name  >  ; 

Closes  (releases)  an  SQL  cursor. 

CREATE  DATABASE  [path]<  database  >  ; 

Creates  a  directory  and  a  set  of  SQL  catalog  tables  for  the 

new  SQL  database. 

CREATE  [UNIQUE]  INDEX  <  index  name> 

ON  <  table  name> 

(<  column  name  >  [[ASC]/DESC] 

[,<  column  name>  [[ASCJ/DESC]  ...]); 

Creates  an  index  based  on  one  or  more  columns  in  a  table 

or  view. 


CREATE  SYNONYM  <  synonym  name> 

FOR  <  table  name  >  ; 

Defines  a^synonyafalternate  name  for  a  table  or  view. 

CREATE  TABLE  <  table  name> 

(<  column  name>  <  data  type > 

[,<  column  name>  <  data  typo  /-.]); 

Creates  a  new  table,  defining  the  columns  within  that  table. 


CREATE  VIEW  <  view  name>  [(<  column  list >  )] 

AS  subselect 

[WITH  CHECK  OPTION]; 

Creates  a  virtual  table  based  on  the  columns  defined  in 
other  tables  or  views. 
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DBCHECK  [<  table  name>  ]; 

Verifies  that  SQL  catalog  tables  contain  current  information 
for  SQL  tables.’ 


DBDEFINE  [<  .dbf  file  >  ];  ,  i. 

Creates  SQL  catalog.entries  inform trticrrt  for  dBASE  data*  At oJDlt, 

base  files.  A  A 


DECLARE  <  cursor  name  >  CURSOR 
FOR  <  SELECT  statement  > 

[FOR  UPDATE  OF  <  column  list >(T) 

/z<  ORDER  BY  Clause  >  1; 

Defines  a  cursor  and  an  associated  SELECT  statement  that 
specifies  a  result  table  on  which  the  cursor  operates. 


DELETE  FROM  <  table  name> 
[<  WHERE  Clause >  ]; 

Q^orm  e — 


DELETE  FROM  <  table  name  > 

WHERE  CURRENT  OF  <  cursor  name>  ; 

Deletes  specified  rows  from  a  tabled) 


DROP  DATABASE  <  database  name>  ; 

Drops  (deletes)  an  SQL  database;  deletes  all  database  (.dbf) 
and  index  (.mdx)  files  in  the  database  directory. 

DROP  INDEX  <  index  name  >  ; 

Drops  (deletes)  an  existing  SQL  index. 

DROP  SYNONYM  <  synonym  name  >  ; 

Drops  (deletes)  an  SQL  synonym  name. 


wove 


<£Q  J 


DROP  TABLE  <  table  name  >  ; 

Drops  (deletes)  an  SQL  table. 

DROP  VIEW  <  view  name>  ; 

Drops  (deletes)  an  SQL  view. 


FETCH  <  cursor  name> 

INTO  <  variable  list>  ; 

Advances  the  cursor  pointer  and  copies  the  values  of  the 
selected  row  into  dBASE  memory  variables. 
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GRANT  [ALL  [PRIVILEGES]  <  privilege  list>  ] 

ON  [TABLE]  <  table  list> 

TO  PUBLIC/ <  user  list> 

[WITH  GRANT  OPTION]; 

Grants  user  privileges  for  access  and  update  of  tables  and 

views. 

INSERT  INTO  <  table  name  > 

[(<  column  list >  )] 

VALUES  (<  value  list  >  )  (<  subselec 

Adds  new  rows  to  a  table. 


LOAD  DATA  FROM  [path]<  filename  > 

INTO  TABLE  <  table  name> 

[[TYPE]  SDF/DIF/WKS/SYLK/FW2/RPD/DBASEII 
DELIMITED  [WITH  BLANK/WITH  <  delimiter >  ]]; 

Imports  data  into  an  SQL  table  from  a  foreign  file. 

A 

OPEN  <  cursor  name  >  ; 

Opens  a  cursor  and  positions  the  cursor  before  the  first  row 
in  the  result  table. 

REVOKE  ALL  [PRIVILEGES]/ <  privileges  list> 

ON  [TABLE]  <  table  name> 

FROM  PUBLIC/ <  user  list>  ; 

Revokes  table  access  and  update  privileges. 

ROLLBACK  [WORK]; 

Restores  a  table  to  its  previous  contents  prior  to  execution 
of  commands  specified  in  a  BEGIN. ..END  TRANSACTION 
block. 

RUNSTATS  [<  table  name>  ]; 

Updates  database  statistics  in  SQL  catalog  tables  of  the  cur¬ 
rent  database. 

SELECT  <  clause  > 

<  ^FROM  <  clause  > 


V- 

0) 

**Ar/c*u 

A 

\Aa  / u  e 

J'  ~s/~. 

A 

Aa 

oi- 


INTO  <  clause  >  1  ) 


[WHERE  <  clause  >  ] 

GROUP  BY  <  clause  >  ] 

HAVING  <  clause  >  ] 

UNION  subselect] 

ORDER  BY  <  clause  >  / FOR  UPDATE  OF  <  clause  >  ] 
SAVE  TO  TEMP  <  clause  >  ; 

Displays  data  in  rows  from  one  or  more  tables. 

SHOW  DATABASE; 

Lists  available  SQL  databases. 

START  DATABASE  <  database  name>  ; 

Activates  an  SQL  database. 
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STOP  DATABASE; 

Closes  the  currently  active  SQL  database. 

UNLOAD  DATA  TO  [path]  <  filename  > 

FROM  TABLE  <  table  name> 
f  [TYPE]  SDF/DIF/WKS/SYLK/FW2/RPD/DBASEII 
A  DELIMITED  [WITH  BLANK/WITH  [delimited]; 

Exports  data  from  an  SQL  table  to  a^foreignTile. 


< 

A 


UPDATE  <  table  name> 

SET  <  column  name  >  =  <  expression  > 
[,<  column  name  >  =  <  expression  >  ...] 
[<  WHERE  search  condition >  ]; 


UPDATE  <  table  name> 

SET  <  column  name>  =  <  expression  > 
[,<  column  name  >  =  <  expression  >  ...] 
v  WHERE  CURRENT  OF  <  cursor  name  >  ; 

^Changes  the  data  in  selected  rows  of  a  tabled 


SQL  Functions 

AVG ([ALL/ DISTINCT]  <  column  name>  ) 

<GD 

f  AVG  ([ALL!  <  column  expression  >  ) 

Computes  the  average  value  of  a  numeric  column  in 
selected  rows. 

COUNT (*/ [DISTINCT]  <  column  name>  ) 

Counts  the  number  of  selected  rows  in  a  query. 

MAX([ALL/DISTINCT]  <  column  name>  ) 


<6D 

qaa: 


</) 


(i) 


Q  you,  yu 


flAX([ALL]  <  column  expression  >  ) 

Returns  the  maximum  value  found  in  specified  columns. 

MIN^LL/DISTINCT]  <  column  name>  ) 

L _ MIN([ALL]  <  column  expression  >  ) 

Returns  the  minimum  value  found  in  specified  columns. 

SUM([ALL/DISTINCT]  <  column  name  >  ) 

<$Q  (TTg) 

f_  ijUM([ALL]  <  column  expression  >  )  - 

Sums  the  values  of  a  numeric  column  in  selected  rows. 
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Cursor  Movement  Keys 


Thelisted  below  move  the  cursor  or  take  an  action  in 
dBA^E  IV.  Except  where  noted  in  parentheses,  the  action 
takes  place  in  all  areas  of  dBASE  IV.  If  an  action  is  followed 
by  a  parenthesized  work  surface  name  (BROWSE,  EDIT, 
Queries,  Memo  field,  or  lists),  or  editing  mode  (Layout  or 
Word  wrap)  the  action  occurs  only  in  that  area  of 
dBASE  IV. 


UUW11  U11V  1UW. 

Next  field  (EDIT). 


Previous  field  (EDIT). 


ACE» 

JUN  1  P.M. 


QUICK  REFERENCE 
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PgDn  *+■ 

(Ctrl-Cj 

Display  next  screen  (BROWSE,  EDIT). 
Down  one  screen  (Word  wrap,  Layout). 

PgUp 


CCtrl-R) 

Display  previous  screen  (BROWSE,  EDIT). 
Up  one  screen  (Word  wrap,  Layout). 

End 


(Ctrl-Bj 

I  of  field  (EDIT). 

Last  field  in  record  (BROWSE). 

Last  text/field  on  line  (Word  wrap,  Layout). 
Last  column  of  skeleton  (Queries). 

Home 

CCtrl-Z" 

Beginning  of  field  (EDIT). 

Beginning  of  record  (BROWSE). 

Left  margin  (Layout). 

Indent,  or  left  margin  (Word  wrap). 

First  column  of  skeleton  (Queries). 

Backspace  o  >-  ^ 


(Ctr1-H> - - - 

Delete  previous  character. 

Tab 


(Ptrl-L 

^Text  field  (BROWSE,  EDIT). 

Next  tab  stop  (Layout). 

Next  column  (Queries,  lists). 

Insert  tab  character  (Word  wrap). 

Shift-Tab 

Previous  field  (EDIT,  BROWSE). 

Previous  tab  stop  (Layout). 

Previous  column  (Queries,  lists). 

Move  margin  left  one  tab  (Word  wrap  if  Enable  auto 
indent  is  on). 


0 
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*  Y  * 

NH5u"field  (BROWSE,  EDIT). 

Form  new  paragraph  (Word  wrap). 

Break  line,  move  to  new  one  (Layout  if  Insert  is  on). 


a* 

Ee 


Esc 

ptrl-CQ 

ave,  abandoning  changes;  cancel  extended  selection. 

Del 

CCtriG" 

Delete  currently  selected  item. 


(Ctrl 

Tog  insert/typeover  modes. 


yCtrl-F^ 

Beginning  of  next  word  or  field. 


CCtrl-AJ 

Beginning  of  previous  word  or  field. 

Ctrl-PgDn 

End  of  text  (Word  wrap). 

Bottom  of  layout  surface  (Layout). 
Last  record  (BROWSE,  EDIT). 


Ctrl-Pgllp 

Beginning  of  text  (Word  wrap). 
Top  of  layout  surface  (Layout). 
First  record  (BROWSE,  EDIT). 


Ctrl-Home 

Move  into  a  memo  field  (Memo  field). 


Ctrl-End 


Save  work  and  leave. 

Move  out  of  memo  field  (Memo  field). 


Ctrl— 

Save  work  and  remain. 


QUICK  REFERENCE 
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Ctrl-Back  space 

Delete  previous  word. 

Ctri-KF 

Finds  the  first  occurrence  of  a  specified  string  (Word  wrap). 
Ctri-KL 

Finds  the  next  occurrence  of  the  string  found  with  Ctrl-KF 
(Word  wrap). 

Ctri-KR 

Reads  another  file  into  the  file  being  edited  (Word  wrap). 
Ctrl-KW 

Writes  the  entire  file  to  another  file  if  no  text  is  selected; 
otherwise,  writes  the  selected  text  (Word  wrap). 

Ctri-K^ 

Repetition  command;  repeats  the  next  keystroke  times 
JWgrd  wrap).  A 

{{NOTE  TO  REVIEWERS:  Will  the  above  keystroke  combi¬ 
nation  be  in  the  product?}} 

Ctrf-N 

Inserts  a  blank  line  after  the  cursor  (Word  wrap). 

Ctrl-T 

^Deletes  all  characters  from  the  current  cursor  position  to 
tlie^eginning  of  the  next  word  (Word  wrap). 

Ctrl-Y 

Deletes  from  the  cursor  to  the  end  of  the  line  (Word  wrap). 
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